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Foreword 

This Technical Specification (TS) has been produced by the 3 rd Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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1 Scope 

The present document covers the minimum characteristics considered necessary in order to provide compliance to 
GSM 03.19 "SIM API for Java Card ™" [7]. 

The present document describes the technical characteristics and methods of test for testing the SIM API for Java Card 
(TM) [7] implemented in the subscriber identity modules (SIMs) for GSM. It specifies the following parts: 

- test applicability 

- test environment description 

- tests format 

- test area reference 
conformance requirements 

- test auite files 

- test procedure 

- test coverage and, 

- a description of the associated testing tools that shall be used. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 



[1] (void) 
[2] (void) 

[3] GSM 11.11: "Digital cellular telecommunication system (Phase 2+); Specification of the 

Subscriber Identity Module - Mobile Equipment (SIM - ME) interface". 

[4] GSM 11.14: "Digital cellular telecommunications system (Phase 2+); 

Specification of the SIM application toolkit for the Subscriber Identity Module - Mobile 
Equipment (SIM - ME) interface". 

[5] GSM 11.17: "Subscriber Identity Module" (SIM) conformance test specification". 

[6] (void) 

[7] GSM 03. 19 Rel-98: "Digital cellular telecommunications system (Phase 2+); Subscriber Identity 

Module Application Programming Interface (SIM API); SIM API for Java Card™; Stage 2". 

[8] GSM 03.48 Rel-99: "Digital cellular telecommunications system (Phase 2+); Security Mechanisms 

for the SIM application toolkit; Stage 2" 

[9] ISO/IEC 7816-3 (1997) " Identification cards - Integrated circuit(s) cards with contacts, Part 3: 

Electronic signals and transmission protocols". 
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[10] GSM 02.19 "Digital cellular telecommunications system (Phase 2+, Release 98); Subscriber 

Identity Module Application Programming Interface (SIM API); Service description; Stage 1". 

[11] SUN Java Card Specification "Java Card 2.1 API Specification". 

[12] SUN Java Card Specification "Java Card 2.1 Runtime Environment Specification". 

[13] SUN Java Card Specification "Java Card 2.1 VM Architecture Specification". 

[14] ETSI TS 101 220 "Numbering System for Telecommunication IC card applications". 

[15] GSM 11.10-1: "Digital cellular telecommunication system (Phase 2+); Mobile Station (MS) 

conformance specification; Part 1: Conformance specification". 

3 Definitions and abbreviations 
3.1 Definitions 



The definitions specified in GSM 11.10-1 [15] clause 3.3 shall apply, unless otherwise specified in the present clause. 

Applet: An Applet is an application built up using a number of classes which will run under the control of the Java 
Card virtual machine. 

Applet installation parameters: Default values for applet installation parameters. 

Applet loading script: File containing the APDU commands that will load and install the test applet in the card. 

CleanUp Script file: File containing the APDU commands that will restore the Default Initial Conditions on the SIM 

Conformance Requirement Reference: Description of the expected card behaviour according to 03.19 specification. 

Expected state: the state in which the SIM is supposed to be after the execution of the test procedure applied on the 
relevant initial conditions 

Security parameters: Minimum security requirements defined for the applet installation process. 

Test Area: Set of Test Cases applicable to a specific part ( class method, framework behaviour,...) of the 03.19 
specification. 

Test Case: Elementary test that checks for compliance with one or more Conformance Requirement References. 
Test Output file: TBD. 

Test procedure: the sequence of actions/commands to perform all the test cases defined in a test area. 

Test Script file: File containing the APDU commands that will execute and verify the test results. 

Test Toolkit Applet: Applet designed to test a specific functionality of the SIM API 03.19 specification. 

3.2 Abbreviations 

For the purpose of the present document, the following abbreviations apply, in addition to those listed in 
GSM 01.04 [2]: 

AC Application Code 

AID Application Identifier 

APDU Application Protocol Data Unit 

API Application Programming Interface 

CAD Card Acceptance Device 

FFS For Further Study 

IFD Interface Device 

JCRE Java Card™ Run Time Environment 
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JVM Java Virtual Machine 

SIM Subscriber Identity Module 

SE Sending Entity 



4 



Test Environment 



This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 



4.1 



Applicability 



The tests defined in this specification shall be performed taking into account the services supported by the card as 
specified in the EF S st file. 

This specification contains tests that test interoperability at the API level. This specification does not currently contain 
tests for interoperability at the SIM API framework and at the byte code level. These are for further study. 

The test defined in this specification are applicable to cards implementing TS 03.19 [7] version 7.4.0 unless otherwise 
stated. 



4.2 Test environment description 

The general architecture for the test environment is: 



Scope of the Test Suite. 
, Elements of the Test Suite 



GSM03.19and 
Java Card™ 2.1 
export files 



Test 
Toolkit 
Applet 



Applet^ 
.cap 



Applet 
installation 
parameter 



TERMING 



Test 
Script 



Cleanup 
Script 



Converter 



Loader: 
OP SMS 

formatter 



APDU 
I/O 



1 



Output 
test 
result 




Applet loading 
script 



APDU 



Applet 
GSM 



Applets 



JAVACARD API 



Tests 
Toolkit 
Applets 



SIM API 



Toolkit Framework 



Toolkit 




Toolkit 




Applet 




Installer 


Registry 




Handler 




triggering 







GSM Framework 



File System 



JCRE 



Note: 



This diagram shows the test architecture required to test interoperability at both API and bytcode level. 
The latter is currently not included in the current specification. The diagram is for information. 
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4.3 Tests format 
4.3.1 Test Area Reference 

Each test area is referenced as follows: 

API Testing:: 'API_[package name]_[classname]_[methodname]' where 
package name: 

sim. access package: T 

sim.toolkit package: '2' 
class name: 

yyy: 3 letters for each class. 

See Annex A for full classes acronyms list, 
method name: 

zzzz [input parameters]: 

See Annex A for full methods name acronyms list. 
FWK: framework testing 
Chapter name: 

xxx: 3 letters for each chapter 
See annex F for full chapter acronyms list 
Subchapter name 

yyyy: : 4 letters for each subchapter 
See annex F for full subchapter acronyms list 
LDR: loader testing 
[TBD] 

4.3.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

- Method prototype as listed in GSM 03. 19 [7] specification. 

- Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN) 

- Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP) 

- Context error: 

- Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC) 
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4.3.1.2 Test Area files 

The files included in the Test Area use the following naming convention: 

- Test Script: [Test Area Reference]_[Test script number]. scr 

- Test Applet: [Test Area Reference]_[Test applet number] .java 
Load Script: [Test Area Reference]_[Load Script number] .ldr 

- Cleanup Script: [Test Area Reference]_[Cleanup Script number] .clr 

- Parameter File: [Test Area Reference]_[Parameter File number] .par 

The test script, applet, installation parameters, load script, cleanup script and conversion parameters numbers start from 
1'. 

The test script, load script and cleanup script shall share a common syntax and format (see Annex B). 

The parameter file has an own syntax (see Annex G) and contains parameters to be used for CAP-file conversion and 
loading/cleanup script generation. 

Scripts file shall be run in the following order: 

[Test Area Reference]_l .ldr 

[Test Area Reference]_l.scr 

[Test Area Reference]_l.clr 

[Test Area Reference]_2.1dr 

[Test Area Reference]_2.scr 

[Test Area Reference]_2.clr 



[Test Area Reference]_n.ldr 
[Test Area Reference]_n.scr 
[Test Area Reference]_n.clr 
In case that one of the files is not needed, it shall be skipped during the tests execution. 

4.3.1.3 Test Procedure 

Each test procedure contains a table to indicate the expected responses form the API and/or the APDU level as follows: 



Test Case 


Id 


Description 


API Expectation 


APDU Expectation 




Test Case detailed description 


API expected behavior. 


Expected response at APDU 
level. 



4.3.1 .4 Test Coverage 

The table at the end of each test procedure indicates the correspondence between the Conformance Requirements 
Reference (CRR) and the different test cases. 
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4.4 Initial Conditions 

The Initial Conditions are a set of general prerequisites for the SIM prior to the execution of testing. For each test 
procedure described in this document, the following rules apply to the Initial Conditions: 

- unless otherwise stated, the file system and the files' content shall fulfil the requirements described in the 
"Default Prepersonalisation" paragraph; 

unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages specific 
to other test procedures shall not be present. 

When both statements apply, a test procedure is said to be in the "Default Initial Conditions" state. 

4.5 Package name 

Java packages integrating this Test Suite shall follow this naming convention: 

sim.test.access.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 
sim.access package. 

sim.test.framework.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 
framework. 

sim.test.util: for the Test util package defined in this Test Suite. 

sim.test.toolkit.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19[7] 
sim.toolkit package. 

Example: The package ../sim.test.access. [Test Area Reference] creates the following directory structure 

../sim/test/access/[Test Area Reference]/API_l _..._[!. .n].*, where API_l_..._[l..n].*' are the 
different test applets Java source files used in [Test Area Reference]. 

4.6 AID Coding 

The AID coding for the Test Packages, Applet classes and Applet shall be as specified in TS 101 220 [14]. In addition, 
the following TAR values are defined for use within the present document: 



TAR Coding (3 bytes/ 24 bits): 



bl 


b2 


b3 


b4 


b5 


b6 


: ; b21 


b22 


b23 


b24 
































Specific Test Applet Name 








































Test Package Identifier 



Test package Identified bits bl4o3): 

000 reserved (as TAR= '00.00.00' is reserved for Card Manager) 

001 API 

010 Framework 

011 Loader 

111 sim.test.util 
other values are RFU 
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Application Provider specific data (1 byte): 
'00' for Package 
'01' for Applet class 
'02' for Applet Instance 

For example, the AID of Package sim.test.util is AO 00 00 00 09 00 02 FFFF FFFF89 E0 00 00 00' 

4.6.1 Specific Test Applet Name for API 



Specific applet test name (bits b4-b24): 



b4 


b5 


b6 


b7 


b8 


b9 


blO 


bll 


b!2 


M3 


b!4 


b!5 


b!6 


b!7 


b!8 


b!9 


b20 


b21 


b22 


b23 


b24 



Applet instance 
Number 

i ! Applet Class Number 

Method 

Class 

API Test Package 

for API Test Package(3 bits) 
001 sim. access 
010 sim. toolkit 
other are RFU 

Class (5 bits): need to be assigned specification order see Annex A for the full list 
Method (6 bits): need to be assigned specification order see Annex A for the full list 

Applet Class Number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance Number (2 bits) defined in the test procedure it shall start with 01 for applet instance and shall 
be 00 for package and class. 

4.6.2 Specific Test Applet Name for Framework 



Specific applet test name (bits b4-b24): 



b4 


b5 


b6 


b7 


b8 


b9 


blO 


bll 


bl2 


b!3 


b!4 


bl5 


bl6 


bl7 


bl8 


b!9 


b20 


b21 


b22 


b23 


b24 



|_RFU ( set to ) 

Applet instance 
| Number 

Applet Class Number 
Test Area within the 
chapter 

Chapter 

for Chapter (5 bits) 

00001 Toolkit Installation Parameters 

00010 Minimum Handler Availability 

00011 Handler Integrity 
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00100 Applet Triggering 

00101 Proactive Command Sending 

001 10 Framework Security 

00111 Envelope Response Posting 

01000 File System Context 

01001 Exception Handling 

01010 Other parts transferred to framework from API 
other are RFU 

Test Area within the chapter (6 bits): values are defined in Annex F 

Applet Class number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance number (3 bits) defined in the test procedure it shall start with 01 for applet instance and shall be 
00 for package and class. 



These subclauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 



This test tool shall meet the following requirements: 

- be able to send command to the card TPDU; 

- be able to check none, only a part, or all of the data returned; 

- be able to check none, only part, or all of the status returned; 
be able to accept all valid status codes returned; 

be able to support Reader commands; 

- be able to generate a log file for each test execution. 

- if more data is returned than defined in the test specification, the tool shall continue; 

- if less data is returned than defined in the test specification, the tool shall aborts and return an error; 

- if there is an error in data or status returned, the tool shall abort and return an error. 
The log file produced by the test tool shall include the following information: 

all commands issued; 
all data returned; 

- all status returned; 

- all errors codes; 

- expected data and status in case of error; 

- comments from the scripts; 

- a log message to report success or failure of the test. 



4.7 



Test Equipment 



4.7.1 



APDU tool 
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4.7.2 Util package 

Annex D includes java source code for the sim.test.util package as well as loading , testing and cleaning script 
examples. 

4.7.3 Applet installation parameters 
4.7.3.1 Security parameters 

Loading scripts shall use the following security parameters as stated in GSM 03.48 [8] for applet installation: 



Parameter 


Value in hexadecimal 


SPI 


OA 00 


KIC 


00 


KID 


11 


TAR 


00 00 00 


CNTR 


00 00 00 00 01 


[ PCNTR 


00 


Key 


01 23 45 67 89 AB CD EF 



4.7.3.2 Loading components 

Cap files in loading scripts shall not include the descriptor component as described in Java Card 2.1 VM Architecture 
Specification [13]. 

4.8 Testing methodology 
4.8.1 Test interfaces and facilities 

The SIM-ME interface provides the main transport interface for the purpose of performing conformance tests. 
The SIM API interface provides the main test interface for the purpose of performing conformance tests. 



5 Test plan 

The test plan is divided according to the SIM API specification, that way the tests will follow the class hierarchy for the 
sim.toolkit and sim.access package; for the SIM Toolkit framework this test plan describes the different points that will 
be tested with the present test specification. 



6 API Test Plan 

6.1 Package sim.access: 
6.1.1 Interface SIM View 

Note: The Test applet shall be run on a class that implements this interface. 

6.1.1.1 Constants 

Test Area Reference: API_l_SVW_CONST 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



19 



ETSI TS 101 955 V8.0.0 (2002-09) 



6.1 .1 .1 .1 Conformance Requirements 

This section does not describe the conformance requirements for a method, but rather for the constants of the interface. 
Normal execution 

CRRN1: The constants shall have the same name and value that is defined in GSM 03.19 [7]. 

6.1.1.1.2 Test Suite Files 

None. 

6.1.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.1 .1 .2 Method select(short fid, byte[] fci, short fciOffset, short fciLength) 

Test Area Reference: API_1_SVW_ SLCTS_BSS 
6.1.1.2.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short select (short fid, 
byte[] fci, 
short fciOffset, 
short fciLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
SIMViewException 

Normal execution 

CRRN1: If the desired file is selected, the length of the FCI (File Control Information) which has been written to the 
array fci is returned. 

CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN4: After selecting a DF/MF no EF is selected. 

CRRN5: After selecting a linear fixed EF no record is selected. 

CRRN6: After selecting a cyclic EF the first record which is the last updated record is selected. 

CRRN7: The current files (file context) of any other applets shall not be changed. See GSM 03.19 [7] - §5.2. This 
will be tested during the testing of the framework. 

CRRN8: The information returned by fci shall be formatted as described in GSM 11.11 [3], §9.2.1. 

CRRN9: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected, 
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5) The MF can always be selected. 
Parameter errors 

CRRP1: If the array fci is null, an instance of NullPointerException shall be thrown. 

CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If fciOffset plus fciLength is greater than the length of the array fci. length, or fciOffset equals fci. length, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC1: If the file with a File-ID which matches fid could not be found according to the selection rules listed in 
CRRN9, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 

CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.2.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 



Test Script: 


API_ 


.1. 


_svw_ 


_SLCTS_ 


_BSS_l.scr 


Test Applet: 


API_ 


.1. 


_svw_ 


_SLCTS_ 


_BSS_l.java 


Load Script: 


API_ 


.1. 


_svw_ 


_SLCTS_ 


BSS_l.ldr 


Cleanup Script: 


API_ 


.1. 


_svw_ 


_SLCTS_ 


_BSS_l.clr 
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6.1.1.2.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Select EFICCID in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
byte[] fci = new byte [34] 
fciOffset = 
fciLength = 20 
select ( ) 


No exception shall be thrown. 
Shall return a value not greater 
than 20. 

<Description of fci: 

XX XX 

XX XX 

2F E2 

04 

> 




2 


Select EFiccid in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
fciOffset = 
fciLength = 13 
select ( ) 


No exception shall be thrown. 
Shall return 13. 

fci shall contain the first 13 bytes of 
the FCI structure. 




3 


Select DFgsm in MF 

fid = S IMView . F ID_DF_GSM 
fciOffset = 
fciLength = 7 
select ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the first 7 bytes 
of the FCI. 

<Description of fci: 

XX XX 
XX XX 
IF 20 

02 
> 




3 


Select DFgsm in MF 

fid = S IMView. FID_DF_GSM 
fciOffset = 
fciLength = 7 
select ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the entire FCI 
structure. 

<Description of fci: 

XX XX 
XX XX 
IF 20 
02 
> 




4 


Select EFacm in DFgsm (CyclicEF) 

fid = S IMView. FID_EF_ACM 
fciOffset = 

_L L, -L -Li C i ILj L 11 — /L\J 

select ( ) 


No exception shall be thrown. 
Shall return a value between 15 
and 20. (Cyclic EF) 
fci shall contain the first 15 or more 
bytes of the FCI structure. 
fci[14] shall have the value 3 
(length of record). 




5 


Select MF 

fid = S IMView. FID_MF 
fciOffset = 
fciLength = 34 
select ( ) 


No exception shall be thrown. 
Shall return a value between 22 
and 34. 

fci shall contain the entire FCI 
structure. 




6 


Select DFtelecom in MF 

fid = S IMView. FID_DF_TELECOM 
fci [0] = fci [1] = ' 05 ' 

fri Offset = 2 
fciLength = 20 
select () 


No exception shall be thrown. 
Shall return 20. 

fci shall contain the first 20 bytes of 
the FCI structure starting at index 
2. The first two bytes shall (still) 
have the value '05'. 




7 


Select EFfdn in DFtelecom (Linear FixedEF) 

fid = S IMView. FID_EF_FDN 
fciOffset = 
fciLength = 15 
select ( ) 


No exception shall be thrown. 
Shall return 15. 

fci shall contain the first 15 bytes of 
the FCI structure. 
fci[14] shall have the value 28 
(length of record). 




8 


fci is null 

fid = S IMView. FID_EF_FDN 
byte[] nullBuffer = null 
fciOffset = 
fciLength = 15 
select ( ) 


Shall throw 

java.lang.NullPointerException. 
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Id 



Description 



API Expectation 



APDU Expectation 



fciOffset < 

fid = SIMView . FID_EF_FDN 
fciOffset = -1 
fciLength = 15 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



10 



fciLength < 

fid = SIMView. FID_EF_FDN 
fciOffset = 
fciLength = -1 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



11 



fciOffset + fciLength > fci. length 

fid = SIMView. FID_EF_FDN 
fciOffset = 20 
fciLength = 15 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



12 



fciOffset >= fci. length 

fid = SIMView. FID_EF_FDN 
fciOffset = 34 
fciLength = 1 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception 



13 



1 - fid = 
fciOffset 
fciLength 
select ( ) 

2 - fid = 
select ( ) 

3 - fid = 
select ( ) 

4 - fid = 
select ( ) 

5 - fid = 
select ( ) 

6 - fid = 
select ( ) 

7 - fid = 
select () 

8 - fid = 
select () 

9 - fid = 
select ( ) 



Selection possibilities 

SIMView. FID_MF 
= 
= 15 

SIMView. FID_DF_TELECOM 
SIMView. FID_DF_GRAPHICS 
SIMView. FID_DF_TELECOM 
SIMView. FID_DF_GRAPHICS 
SIMView. FID_MF 
SIMView. FID_DF_GSM 
SIMView. FID_DF_TELECOM 
SIMView. FID_DF_TELECOM 



1 - No exception 

2 - No exception 

3 - No exception 

4 - No exception 

5 - No exception 

6 - No exception 

7 - No exception 

8 - No exception 

9 - No exception 



shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 



thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown. 
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EF not selected after MF/DF selection 

1 - fid = SIMView. FID_MF 

select () 

fid = SIMView. FID_EF_ICCID 
select () 

2 - fid = SIMView. FID_MF 
select ( ) 

readBinary ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 



15 



No selection of non-reachable file 

1 - fid = SIMView. FID_MF 
select ( ) 

2 - fid = SIMView. FID_EF_ACM 
select ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code FILE NOT FOUND. 
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No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView. FID_MF 

select ( ) 

2 - fid = FID_DF_SIMTEST 

select ( ) 

3 - fid = F I D_E F_L ARU 

select () 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD_NUMBER_NOT_AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 
select ( ) 

2 - fid = FID_DF_SIMTEST 

select () 

3 - fid = F I D_E F_C ARU 
select () 

4 - byte[] datal = { 1,2,3 } 
mode = REC„ACC_MODE_PREVIOUS 
updateRecord (datal ) 

5 - fid = F I D_E F_C ARU 
select () 

readRecord (data2 ) 
compare datal to data2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 

oi icin uc iuc 1 1 uocii . 





6.1.1.2.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


1-7 


N2 


3, 5 


N3 


1,2, 4, 6,7 


N4 


14 


N5 


16 


N6 


17 


N8 


1,3 


N9 


1-7, 13 


P1 


8 


P2 


9 


P3 


10 


P4 


11,12 


C1 


15 


C2, C3 


Not Tested 



6.1.1.3 Method select (short fid) 

Test Area Reference: API_1_SVW_SLCTS 

6.1.1.3.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void select (short fid) 

throws SIMViewException 

Normal execution 

CRRN1: If the desired file is selected, no exception is thrown. 

CRRN2: After selecting a DF/MF no EF is selected. 

CRRN3: After selecting a linear fixed EF no record is selected. 

CRRN4: After selecting a cyclic EF the first record which is the last updated record is selected. 

CRRN5: The current files (file context) of any other applets shall not be changed [03.19 - §5.2]. This will be tested 
during the testing of the framework. 

CRRN6: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected, 
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5) The MF can always be selected. 

Parameter errors 

No requirements. 

Context errors 

CRRC1: If the file with a File-ID which matches fid could not be found according to the selection rules listed in 
CCRN6, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 

CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.3.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 



Test Script: 


API_ 


.1. 


_svw_ 


_SLCTS_ 


.l.scr 


Test Applet: 


API_ 


.1. 


_svw_ 


_SLCTS_ 


l.java 


Load Script: 


API_ 


.1. 


_svw_ 


_SLCTS_ 


Lldr 


Cleanup Script: 


APT. 


.1. 


_svw_ 


_SLCTS_ 


l.clr 
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6.1.1.3.3 



Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



SIM Initialisation 



Responses ignored. 



Select EFiccid in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
select ( ) 



No exception shall be thrown. 



EF not selected after MF/DF selection 

1 - fid = SIMView.FID_MF 
select ( ) 

fid = SIMView.FID_EF_ICCID 
select ( ) 

2 - fid = SIMView.FID_MF 
select ( ) 

readBinary ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 



No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 

select ( ) 

2 - fid = FID_DF_SIMTEST 
select ( ) 

3 - fid =FID_EF_LARU 
select ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD_NUMBER_NOT_AVAIL 
ABLE. 



Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 
select () 

2 - fid =FID_DF_SIMTEST 

select () 

3 - fid = F I D_E F_C ARU 
select () 

4 - byte[] datal = { 1,2,3 } 
updateRecord (datal ) 

5 - fid = F I D_E F_C ARU 
select ( ) 

readRecord (data2 ) 
compare datal to data2 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 
shall be identical. 



Selection possibilities 



1 - fid = 


SIMView 


FID_ 


_MF 




select ( ) 










2 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select ( ) 










3 - fid = 


SIMView 


FID_ 


_DF_ 


.GRAPHICS 


select ( ) 










4 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select ( ) 










5 - fid = 


SIMView 


FID_ 


_DF_ 


.GRAPHICS 


select ( ) 










6 - fid = 


SIMView 


FID_ 


_MF 




select ( ) 










7 - fid = 


SIMView 


FID_ 


_DF_ 


.GSM 


select ( ) 










8 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select ( ) 










9 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select ( ) 











1 - No exception 

2 - No exception 

3 - No exception 

4 - No exception 

5 - No exception 

6 - No exception 

7 - No exception 

8 - No exception 

9 - No exception 



shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 



thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown. 



No 

1 - fid = 
select ( ) 

2 - fid = 
select ( ) 



selection of unreachable file 

SIMView. FID_MF 
SIMView. FID_EF ACM 



1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code FILE NOT FOUND. 



6.1.1.3.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1 


N2 


2 


N3 


3 


N4 


4 


N6 


5 


C1 


6 


C2, C3 


Not Tested 
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6.1.1.4 Method status 

Test Area Reference: API_1_SVW_STAT_BSS 

6.1.1.4.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short status (byte [ ] fci, 

short fciOffset, 
short fciLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
SIMViewException 

Normal execution 

CRRN1: The FCI (File Control Information) of the current DF (or MF) is returned in the same format as for a 
SELECT command in case of selecting an MF/DF (described in GSM 03.19 [7], §9.2.1). 

CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

Parameter errors 

CRRP1: If the array fci is null, an instance of NullPointerException shall be thrown. 

CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If fciOffset plus fciLength is greater than the length of the array fci. length, or fciOffset equals fci. length, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC1: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.4.2 Test Suite Files 

Additional requirements for the GSM personalisation: 



Test Script: 


API_ 


1. 


_svw_ 


STAT 


_BSS_ 


.l.scr 


Test Applet: 


API_ 


.1. 


_svw_ 


STAT 


_BSS_ 


.l.java 


Load Script: 


API_ 


.1. 


_svw_ 


STAT 


_BSS_ 


.l.ldr 


Cleanup Script: 


API_ 


1. 


_svw_ 


STAT 


_BSS_ 


.l.clr 
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6.1.1.4.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Status of MF 

byte[] fci = new byte [34] 
fciOffset = 
fciLength = 7 
status ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the entire FCI 
structure. 

<Description of fci: 

XX XX 

XX XX 

3F00 

01 

> 




2 


Status after select EFiccid in MF 

1 - fid = SIMView.FID_DF_GSM 
fciOffset = 

fciLength = 34 
len = select ( ) 

2 - byte[] fci2 = new byte [34] 

len2 = status ( ) 

3 - Compare len and len2 

4 - Compare the len bytes of fci and fci2 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return 22 or more. 

3 - len and Ien2 shall be identical 

4 - fci and fci2 shall be identical 




3 


StatUS Of DFielecom 

1 - fid = SIMView . FID_DF_TELECOM 
select () 

2 - fciOffset = 
fciLength = 100 
status ( ) 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return a value between 22 
and34. 

fci shall contain the entire FCI 
structure (check that returned value 
is equal to 13 plus the "length of 
following data" - fci[12]).FID of the 
returned fci (fci[4:5]) is 
FID_DF_TELECOM. 




4 


Status DFtelecom 

fciOffset = 
fciLength = 7 
status ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the first 7 bytes of 
the FCI structure starting at index 
0. 

FID of the returned fci (fci[4:5]) is 
rlU Ur 1 tLtCUM. 




5 


fci is null 

byte[] nullBuffer = null 
fciOffset = 
fciLength = 34 
status ( ) 


Shall throw 

java.lang.NullPointerException. 




6 


fciOffset < 

fciOffset = -1 
fciLength = 34 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




7 


fciLength < 

fciOffset = 
fciLength = -1 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




8 


fciOffset + fciLength > fci. length 

fciOffset = 20 
fciLength = 15 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




9 


fciOffset >= fci. length 

fciOffset = 34 
fciLength = 1 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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CRR Number 


Test Case Number 


N1 


1-4 


N2 


2, 3 


N3 


1,4 


P1 


5 


P2 


6 


P3 


7 


P4 


8, 9 


C1, C2 


Not Tested 



6.1 .1 .5 Method readBinary 

Test Area Reference: API_1_SVW_REDBS_BSS 
6.1.1.5.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short readBinary ( short fileOffset, 

byte [ ] resp, 
short respOffset, 
short respLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
SIMViewException 

Normal execution 

CRRN1: If data can be accessed at the specified offset, the value respOffset plus respLength are returned and the 
data bytes of the currently selected transparent file are returned in resp. 

Parameter errors 

CRRP1: If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUND ARIES . 

CRRP2: If fileOffset plus respLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_FILE_BOUND ARIES. 

CRRP3: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP4: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If respOffset plus respLength is greater than the length of the array resp. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for the reading of an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.5.2 Test Suite Files 

Additional requirements for the GSM personalisation: none. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.1.1.5.3 



API_1_S VW_REDBS_BSS_1 .scr 
API_l_SVW_REDBS_BSS_l.java 
API_1_S VW_REDBS_BSS_1 .ldr 
API_1_S VW_REDBS_BSS_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored 




1 


Read from EFICCID in MF (Transparent EF) 

1 - fid = SIMView.FID_EF_ICCID 
select ( ) 

2 - fileOffset = 
byte[] resp = new byte [20] 
resp[0:19] = '55' 
respOffset = 10 
respLength = 10 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Shall return 20. 

resp shall contain the entire 

pnntpntQ nf FFIf*.f"*.in Qtartinn at 

UUI 1 LCI 1 Lo U 1 1— 1 1 vv/IU oLdl LI 1 ILJ CU 

index 10. 

description of resp: 

55 55 55 55 55 55 55 55 55 55 

OF FF FF FF FF FF FF FF FF FF 

> 




2 


Read from EFICCID in MF 

resp[0:19] = '55' 
fileOffset = 5 
respOffset = 10 
respLength = 5 
readBinary ( ) 


No exception shall be thrown. 
Shall return 15. 

resp shall contain the last 5 bytes 

of EFICCID starting at index 10. 

description of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF 55 55 55 55 55 

> 




3 


Offset into File out of bounds 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




4 


fileOffset + respLength > EF length 

fileOffset = 9 
respOffset = 
respLength = 2 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


resp is null 

byte[] nullBuffer = null 
fileOffset = 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


respOffset + respLength > resp.length 

fileOffset = 
respOffset = 10 
respLength = 11 
readBinary ( ) 


Shall throw 
java.lang. 

Array IndexOutOfBoundsException. 




9 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = F I D_E F_L ARU 
select ( ) 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




10 


Access condition not fulfilled 

1 - fid = DFSIMTTEST 
select ( ) 

2 - fid = EFTNR 

select ( ) 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




11 


EF is invalidated 

1 - fid = EFTNU 

invalidate ( ) 

2 - readBinary () 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 




12 


No EF selected 

1- fid = SIMView.FID_MF 

select () 

2 readBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 





6.1.1.5.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


1-2 


P1 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


P6 


8, 


C1 


12 


C2 


9 


C3 


10 


C4 


11 


C5, C6 


Not Tested 



6.1 .1 .6 Method updateBinary 

Test Area Reference: API_1_SVW_UPDBS_BSS 
6.1.1.6.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void updateBinary ( short fileOffset, 

byte[] data, 
short dataOffset, 
short dataLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOfBoundsException, 
SIMViewException 
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Normal execution 

CRRN1: The currently selected transparent file is updated starting at fileOffset, with the string of dataLength bytes 
in the array data starting at dataOffset. 

Parameter errors 

CRRP1: If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUND ARIES . 

CRRP2: If fileOffset plus dataLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_FILE_BOUND ARIES. 

CRRP3: If the array data is null, an instance of NullPointerException shall be thrown. 

CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating of an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.6.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 



Test Script: 


API_ 


.1. 


_svw_ 


_UPDBS_ 


_BSS_ 


l.scr 


Test Applet: 


API_ 


.1. 


_svw_ 


_UPDBS_ 


_BSS_ 


l.java 


Load Script: 


API_ 


.1. 


_svw_ 


_UPDBS_ 


_BSS_ 


_l.ldr 


Cleanup Script: 


API_ 


.1. 


_svw_ 


_UPDBS_ 


_BSS_ 


.l.clr 
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6.1.1.6.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




2 


Update Transparent EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTARU 
select ( ) 

3 - fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

4 - fileOffset = 3 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

H- InU CAOcLJLILM I olld.il Uc IIIIUVVII. 

Data in resp[0] shall be '55'. 




3 


1 - fileOffset = 254 

data[0] = '55' 
data[l] = 'AA' 
data [2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary ( ) 
2 - fileOffset = 254 
respOffset = 
respLength = 3 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1] = 'AA' 
respL^ij = do 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte[] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 

dataOffset = -1 
dataLength = 10 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = F I D_E F_L ARU 
select () 

3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




11 


Access condition not fulfilled 

1 - fid = DFSIMTEST 
select ( ) 

fid = EFTNU 

select () 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




12 


EF is invalidated 

1 - fid = EFTNR 
invalidate ( ) 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 





6.1.1.6.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


2, 3 


P1 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


C1 


1 


C2 


10 


C3 


11 


C4 


12 


C5, C6 


Not Tested 



6.1 .1 .7 Method readRecord 

Test Area Reference: API_1_SVW_REDRSBS_BSS 
6.1.1.7.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short readRecord ( short recNumber, 

byte mode, 
short recOffset, 
byte[] resp, 
short respOffset, 
short respLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
SIMViewException 

Normal execution 

CRRN1: The data bytes from the record, specified by mode and recNumber of the currently selected linear fixed or 
cyclic EF, is read at recOffset. A total of respLength bytes of this data is copied to the array resp at respOffset. 
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CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT: 

if recNumber is not 0, the record addressed by recNumber will be read; 

if recNumber is the current selected record will be read; and 

the current record pointer shall not change. 
CRRN3: If the access mode is REC_ACC_MODE_NEXT: 

the next record relative to the current selected record will be selected and read; 

if no current record is selected, the first record will be selected and read; 

if the current record pointer is set to the last record for a cyclic EF the record pointer is set to the first record 
and the record is read; 

the current record pointer of any other applet shall not be changed. 
CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

the previous record relative to the current selected record will be selected and read; 
if no current record is selected, the last record will be selected and read; 

if the current record pointer is set to the first record, for a linear fixed EF the method responses with an error 
exception and for a cyclic EF the record pointer is set to the last record and the record is read; 

the current record pointer of any other applet shall not be changed. 

Parameter errors 

CRRP1: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP2: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and the 
current record pointer is set to the first record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP6: If recOffset plus respLength is greater than the record length, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. INVALID_MODE. 

CRRP8: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP10: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP1 1: If respOffset plus respLength is greater than the length of the array resp. length, or respOffset equals 
resp. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 
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Context errors 

CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.7.2 Test Suite Files 



Additional requirements for the GSM personalisation: None 



Test Script: 


API_ 


.1. 


_svw_ 


_REDRSBS_ 


_BSS_ 


.l.scr 


Test Applet: 


API_ 


1. 


_svw_ 


_REDRSBS_ 


_BSS_ 


.l.java 


Load Script: 


API_ 


.1. 


_svw_ 


_REDRSBS_ 


_BSS_ 


_l.ldr 


Cleanup Script: 


API_ 


.1. 


_svw_ 


_REDRSBS_ 


_BSS_ 


.l.clr 



6.1.1.7.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 

byte[] resp = new byte [20] 
respOffset = 
respLength = 10 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Read Absolute and Current from Linear Fixed 
EF 

1 - fid = DFSIMTEST 
select () 

2 - fid = EFLARU 
select ( ) 

// Record pointer not set. 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

4 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 

5 - recNumber = 1 
readRecord ( ) 

6 - recNumber = 

resp[0] = resp[l] = resp[2] = resp[3] = 
' 00 ' 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 
resp[3] = 'AA' 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

6 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 




3 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = 'AA' 

resp[1] = 'AA' 

resp[2] = 'AA' 

resp[3] = 'AA' 




4 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




5 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = '55' 

resp[1] = '55' 

resp[2] = '55' 

resp[3] = '55' 




6 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC__ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Read Absolute and Current from Cyclic EF 

1 - fid = EFCARU 
select ( ) 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

3 - recNumber = 1 
readRecord ( ) 

4 - recNumber = 

resp[0] = resp[l] = resp[2] = '00 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = ' AA' 
resp[1] = ' AA' 
resp[2] = ' AA' 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp|/ij = oo 




8 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




9 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




10 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




11 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




12 


Read Absolute from Linear Fixed EF beyond 

Records 

1 - fid = EFLARU 
select () 

2 — recNumber = —1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 - recNumber = 3 
readRecord ( ) 


1 - No exceptionshall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




13 


No current record in linear fixed EF, read 

current 

1 - fid = EFLARU 

select () //No curr rec 

2 - recNumber =0 // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


recOffset < 

1 - fid = EFLARU 
select ( ) 

2 - recNumber =1 // rec 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = -1 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 




15 


recOffset + respLength > Record Length 

1 - fid = EFLARU 
select () 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 2 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 




16 


Reading with invalid mode 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 
mode = 1 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 — mode = 5 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code INVALIDMODE. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID MODE. 




17 


resp is null 

byte[] nullBuffer = null 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

respOffset = 

respLength = 10 

readRecord ( ) 


Shall throw 

java.lang.NullPointerException. 




18 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord () 


Shall throw 
java.lang. 

Array IndexOutOfBoundsException. 




1 Q 

i y 


respLengm < u 

respOffset = 
respLength = -1 
readRecord () 


onan mrow 
java.lang. 

ArraylndexOutOfBoundsException. 




20 


respOffset + respLength > resp.length 

respOffset = 10 
respLength = 11 
readRecord () 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1 - fid = DFSIMTEST 
s s lsct ( ) 

2 - fid = EFTNU 

select ( ) 

3 - respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNR 


1 - No exception shall be thrown. 

2 - Shall throw 






select ( ) 

2 - respLength = 3 
readRecord ( ) 


sim. access. SIMViewException with 
reason code 






AC NOT FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNU 
invalidate ( ) 

2 - readRecord () 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 
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CRR Number 

VI II 1 llUlllwCI 


1 C3l vQOC MUIIIUCI 


N1 

IN I 




N9 


9 7 


I NO 


T 8 Q 

O, O, <J 


N4 


c; -in 11 

J, I W, 1 1 


P1 


1 2 


P? 


I o 


r o 


A 
t 


P4 


C 


P 1 ! 


14 


PR 




P7 


1 R 


P8 


17 


P9 


18 


P10 


19 


P11 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1 .1 .8 Method updateRecord 

Test Area Reference: API_1_SVW_UPDRSBS_BSS 
6.1.1.8.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void updateRecord ( short recNumber, 

byte mode, 
short recOffset, 
byte [ ] data, 
short dataOffset, 
short dataLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
SIMViewException 

Normal execution 

CRRNl: dataLength bytes of the record specified by mode and recNumber of the current selected linear fixed or 
cyclic EF are updated at recOffset, by using the string of bytes in the array data starting at dataOffset. 

CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT and the file is a linear fixed EF: 

- the record addressed by recNumber will be updated; 

if recNumber is the current selected record will be updated; and 

the current record pointer shall not change. 
CRRN3: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF: 

the next record relative to the current selected record will be selected and updated; 

if no current record is selected, the first record will be selected and updated; 

the current record pointer of any other applet shall not be changed. 
CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

the previous record relative to the current selected record will be selected and updated; 
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if no current record is selected, the last record will be selected and updated; 

if a cyclic EF is updated, the oldest record will be updated independent of the current record pointer and this 
record becomes record number 1 and the current record; 

the current record pointer of any other applet shall not be changed in case of a linear fixed EF. 

Parameter errors 

CRRP1: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP2: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and the 
current record pointer is set to the first record; an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP6: If recOffset plus dataLength is greater than the record lengh, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. INVALID_MODE. 

CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 

REC_ACC_MODE_PREVIOUS, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALID_MODE. 

CRRP9: If the array data is null, an instance of NullPointerException shall be thrown. 

CRRP10: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP1 1: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP12: If dataOffset plus dataLength, is greater than the length of the array data. length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.8.2 Test Suite Files 

Additional requirements for the GSM personalisation: This test is based on the assumption that the contents of the EFs 
in DF SIMTEST are identical to those defined in the default pre-personalisation and the current record pointers have not 
been altered. 



Test Script: 


API_ 


.1. 


_svw_ 


UPDRSBS. 


_BSS_ 


.l.scr 


Test Applet: 


APT. 


.1. 


_svw_ 


_UPDRSBS_ 


_BSS_ 


l.java 


Load Script: 


API_ 


.1. 


_svw_ 


_UPDRSBS_ 


_BSS_ 


l.ldr 


Cleanup Script: 


API_ 


.1. 


_svw_ 


_UPDRSBS_ 


_BSS_ 


l.clr 
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6.1.1.8.3 Test Procedure 



Is! 

lu 


Description 


API Expectation 


Aruu expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 

byte[] data = new byte [20] 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




2 


Update Absolute and Current from Linear 
Fixed EF 

1 - fid = DFSIMTEST 

select ( ) 

2 - fid = EFLARU 
select ( ) 

// Record pointer not set. 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

data [0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

respOffset = 

respLength = 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = '11' 
Resp[1] = '11' 
Resp[2] = '11' 
Resp[3] = '11' 


= 4 


3 


Update Current from Linear Fixed EF 

1 - fid = DFSIMTEST 
select () 

2 - fid = EFLARU 
select ( ) 

// Set record pointer with mode "next". 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data [0:3] = '00' 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

// write data with mode "current" 

4 - recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord ( ) 

// read result with mode "absolute" 
respOffset = 
respLength = 4 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '22' 
resp[1] = '22' 
resp[2] = '22' 
resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no record 
pointer set 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = F I D_E F_L ARU 

select 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = '33' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 
3 - No exception shall be thrown. 
Resp shall be: 

Resp[1] = '33' 
Resp[2] = '33' 
Resp[3] = '33' 




5 


Update Next from Linear Fixed EF, record 
pointer set 

1 - recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = '44' 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = '44' 
resp[1] = '44' 
resp[2] = '44' 
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Id 


Description 


API Expectation 


APDU Expectation 




dataOffset = 
dataLength = 4 
updateRecord ( ) 

2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


resp[3] = '44' 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Update Next from Linear Fixed EF, no more 
records 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = '55' 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


Shall throw 

All m\ /■ 1— ■ . 1 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




7 


Update Previous from Linear Fixed EF, no 
record pointer set 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select ( ) 

3 - recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data[0:3] = '66' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 

4 - mode = REC ACC MODE ABSOLUTE CURRENT 
readRecord { ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '66' 

rpcnll 1 — 'fifi' 
1 CO|J[ 1 J — uu 

resp[2] = '66' 
resp[3] = '66' 




8 


Update Previous from Linear Fixed EF, record 
pointer set 

1 - recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data[0:3] = '77' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 
readRecord ( ) 

2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


1 - No exception shall be thrown 

2 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = '7744' 
Resp[1] = '7744' 
Resp[2] = '7744' 
Resp[3] = '7744' 




9 


Update Previous from Linear Fixed EF , no 
more records 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data [0:3] = '88' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 


Shall throw 

All m\ /■ 1— ■ . 1 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




10 


Update Previous from Cyclic EF 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_CARU 
select ( ) 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

4 - recNumber = 2 

mode = REC„ACC_MODE_PREVIOUS 
data[0:2] = resp[0:2] A 'FF' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

5 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
respOffset = 
respLength = 3 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = data[0] 
resp[1] = data[1] 
resp[2] = data[2] 




11 


Update Absolute from Linear Fixed EF beyond 
Records 

1 - fid = EFLARU 
select ( ) 

2 -recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 4 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 

3 - Shall throw 

sim. access. SIMViewException with 
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Id 


Description 


API Expectation 


APDU Expectation 




updateRecord ( ) 

2 - recNumber = 3 

updateRecord ( ) 


reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


No current record in linear fixed EF, update 
current 

1 - fid = EFLARU 

select () // No curr rec 

2 — rscNumbsr = // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




13 


recOffset < 

1 - fid = EFLARU 


1 - No exception shall be thrown. 

2 - Shall throw 






select () 

2 it s c N umb s it = T // irsc 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = -1 


sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 






dataOffset = 






dataLength = 4 








updateRecord ( ) 






14 


recOffset + dataLength > Record Length 

1 - fid = EFLARU 


1 - No exception shall be thrown. 

2 - Shall throw 






select ( ) 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 2 


sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 






dataOffset = 






dataLength = 4 
updateRecord ( ) 






15 


Updating with invalid mode 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 
mode = 1 

i- C W J- J- D C L. — U 

dataOffset = 
dataLength = 4 
updateRecord ( ) 

3 - mode = 5 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code INVALIDMODE. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID MODE. 




16 


Updating Cyclic EF with invalid mode 

1 - fid = DFSIMTEST 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 






select ( ) 

2 - fid = EFCARU 
select ( ) 

3 - recNumber = 

mode = REC„ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 


3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID MODE. 






t Ol ICUI LI 1 1 U VV 

sim. access. SIMViewException with 
reason code INVALID MODE. 






dataOffset = 


5 - Shall throw 






dataLength = 3 
updateRecord ( ) 
4 - recNumber = 


sim. access. SIMViewException with 
reason code INVALID MODE. 






mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








updateRecord ( ) 








5 - recNumber = 2 








mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








updateRecord ( ) 






17 


data is null 

byte[] nullBuffer = null 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 

java.lang.NullPointerException. 




1 ft 

I o 


dataOffset = -1 
dataLength = 10 
updateRecord ( ) 


Ol lew Ull uw 

java.lang. 

ArraylndexOutOfBoundsException. 




1 Q 


udictmny hi < u 

dataOffset = 
dataLength = -1 
updateRecord ( ) 


Qhall thrruA/ 

oiidii inruw 
iava lann 

ArraylndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 


1 - No exception shall be thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 




1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTNR 

select ( ) 

3 - dataOffset = 
dataLength = 4 
updateRecord ( ) 


2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNU 
select () 

2 - recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 
updateRecord ( ) 

3 - fid = EFLNU 
select () 

4 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNR 
invalidate ( ) 

2 - updateRecord ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 





6.1.1.8.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


2, 3,4, 5, 7, 8, 10 


N2 


2, 3 


N3 


5, 6 


N4 


7, 8, 9, 10 


P1 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1.1.9 Method seek 

Test Area Reference: API_1_SVW_SEEKB_BSS 
6.1.1.9.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short seek (byte mode, 

byte[] patt, 
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short pattOffset, 
short pattLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
SIMViewException 

Normal execution 

CRRN1: If the pattern in patt with the length pattLength at offset pattOffset is found in the record being specified by 
mode, the current record pointer is set to that record and the record number is returned. The record pointer of any 
other applet is not changed. This will be tested during the testing of the framework. 

CRRN2: If mode is SEEK_FROM_BEGINNING_FORWARD, the search starts with the first record forward 
towards the end of the file. 

CRRN3: If mode is SEEK_FROM_END_BACKWARD, the search starts with the last record backward towards the 
beginning of the file. 

CRRN4: If mode is SEEK_FROM_NEXT_FORWARD, the search starts from the next record after the current 
record pointer forward towards the end of file. If no current record pointer is selected, the search starts with the 
first record. 

CRRN5: If mode is SEEK_FROM_PREVIOUS_BACKWARD, the search starts from the previous record before 
the current record pointer backward towards the beginning of the file. If no current record pointer is selected the 
search starts with the last record. 

CRRN6: If pattern in patt is not found, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

CRRN7: If mode is S EEK_FROM_NEXT_FOR W ARD and the record pointer is at the last record, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. PATTERN_NOT_FOUND. 

CRRN8: If mode is SEEK_FROM_PREVIOUS_BACKWARD and the record pointer is at the first record, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

Parameter errors 

CRRP1: If mode is not between and 3 inclusive (0 = SEEK_FROM_BEGINNING_FORWARD, etc.), an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

CRRP2: If the pattern array patt is null, an instance of NullPointerException shall be thrown. 

CRRP3: If pattOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If pattLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If pattLength is greater than the size of the record of the currently selected EF, an instance of 
SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP6: If pattOffset plus pattLength is greater than the length of the pattern array patt.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not linear fixed, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 
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CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.9.2 Test Suite Files 



Additional requirements for the GSM personalisation: None 



Test Script: 


API_ 


.1. 


_svw_ 


_SEEKB_ 


_BSS_ 


l.scr 


Test Applet: 


API_ 


„1_ 


_svw_ 


_SEEKB_ 


_BSS_ 


l.java 


Load Script: 


API_ 


.1. 


_svw_ 


_SEEKB_ 


_BSS_ 


.l.ldr 


Cleanup Script: 


API_ 


.1. 


_svw_ 


_SEEKB_ 


_BSS_ 


.l.ldr 



6.1.1.9.3 Test Procedure 



\r\ 

i a 


Description 


Ari expectation 


akuu expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

Byte[] patt = new byte [20] 
pattLength = 10 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 1 
sim. access. SIMViewException with 
reason code NU tr btLtu I tu. 




2 


Pattern not Found 

1 - fid = DFSIMTEST 

cpl pfif M 
OCXCU L \ J 

2 - fid = EFLARU 
select ( ) 

3 - patt [0] = 'DA' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
o - shall throw 

c i m q r^no c Q 1 ^ VI \. / i oia/F vr'Or^ti n n \A/ith 
oil 1 1 .dLfLitfoo.OI Ivl V Ic vvrZAUc|J LIUI 1 Wl LI 1 

reason code 

PATTERNNOTFOUND. 




3 


Seek from Beginning Forward 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 




4 


Seek from End Backward 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEE K_F ROM_E ND_B ACKWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 




5 


Seek from Next Forward 

patt [0:2] = 'AA' 
pattOffset = 
pattLength = 3 

mode = SEE K_F ROM_NE X T_F ORWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 2 




6 


Last Record, Seek from Next Forward 

mode = SEE K_F ROM_NE X T_F ORWARD 
seek ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

PATTERN NOT FOUND. 




7 


Seek from Previous Backward 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_PREVIOUS_BACKWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 




8 


First Record, Seek from Previous Backward 


Shall throw 
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Id 


Description 


API Expectation 


APDU Expectation 




SEEK_FROM_PREVIOUS_BACKWARD 
seek ( ) 


sim. access. SIMViewException with 
PATTERN NOT FOUND. 




9 


Pattern not Found (out of reach) 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEE K_F ROM_NE X T_F ORWARD 
seek ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

PATTERNNOTFOUND. 




10 


Invalid mode 

1 - mode = 4 
seek ( ) 

2 - mode = -1 
seek ( ) 


1 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID MODE 

2 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID MODE 




11 


patt is null 

byte[] nullBuffer = null 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek () 


Shall throw 

java.lang.NullPointerException. 




12 


pattOffset < 

patt[0:2] = '55' 
pattOffset = -1 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




13 


pattLength < 

patt[0:2] = '55' 
pattOffset = 
pattLength = -1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




14 


pattLength > size of record 

patt[0:4] = '55' 
pattOffset = 
pattLength = 4 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S 




15 


pattOffset + pattLength > patt.length 

patt[0:2] = '55' 
pattOffset = 1 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




16 


EF is not Linear Fixed 

1 - fid = EFTNU 

select () 

2 - pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 

3 - fid = EFCNU 
select ( ) 

seek ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT 




17 


Access condition not fulfilled 

1 - fid = EFLNR 
select () 

2 - patt [0] = ' 55 ' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




18 


EF is invalidated 

1 - fid = EFLARU 
select ( ) 

2 - invalidate ( ) 

3 - patt [0] = '55 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

4 - No exception shall be thrown. 
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CRR Number 

VI II 1 llUlllwCI 


1 C3l vQOv MUIIIUCI 


N1 

IN I 


9 T - fi 7 


N9 


o 


I NO 


t 


N4 


c; 

o 


I NO 


7 


Nfi 

I NO 


9 fi 8 Q 


N7 


R 
u 


I NO 


Q 
o 


P1 


1 n 


P2 


1 1 


P3 


12 


P4 


13 


P5 


14 


P6 


15 


C1 


1 


C2 


16 


C3 


17 


C4 


18 


C5, C6 


Not Tested 



6.1.1.10 Method increase 

Test Area Reference: API_1_SVW_INCR_BS_BS 
6.1.1.10.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short increase (byte [ ] incr, 

short incrOffset, 
byte[] resp, 
short respOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
SIMViewException 

Normal execution 

CRRN1: The value in the array incr is added to the value of the last increased / updated record in the currently 
selected cyclic EF. The result is stored in the oldest record and returned in the array resp. The updated record 
becomes record number 1 and is selected as current record. The number of bytes of valid data in resp is returned. 

Parameter errors 

CRRP1: If the array incr is null, an instance of NullPointerException shall be thrown. 

CRRP2: If incrOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If incrOffset plus the value 3, is greater than the length of the array incr.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If the result of the addition is greater than the maximum value of the record (represented by all bytes set to 
'FF'), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.MAX_VALUE_REACHED. 

CRRP5: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP6: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP7: If the remaining length of the array resp at the offset respOffset is less than the length of the record, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 
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Context errors 



CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not cyclic, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If increase is not allowed as indicated by the FCI byte 8 (GSM 11.11: FCI structure of an EF returned by 
the SELECT command), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILEJNCONSISTENT. 

CRRC4: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 

CRRC5: If the currently selected EF is invalidated, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC6: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC7: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.10.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 
Test Script: API_l_SVW_INCR_BS_BS_l.scr 
Test Applet: API_l_SVW_INCR_BS_BS_l.java 
Load Script: API_l_SVW_INCR_BS_BS_l.ldr 
Cleanup Script: API_l_SVW_INCR_BS_BS_l.clr 



6.1.1.10.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

byte[] incr = new byte [4] 
byte[] resp = new byte [4] 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




2 


Increase , verify response 

1 - fid = DFSIMTEST 
select () 

2 - fid = EFCARU 
select ( ) 

3 - //Set both records to 00 00 00 
mode = REC_ACC_MODE_PREVIOUS 

data [0:3] = 
dataOffset = 
dataLength = 3 
updateRecord ( ) 
updateRecord ( ) 

4 - incrOffset = 
incr[2] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
resp[] shall contain {0,0,1 ,0}. 




3 


Increase, verify file 

1 - incrOffset = 1 
incr[2] = 0, incr[3] = 2 
respOffset = 1 
increase ( ) 

2 - resp[3] = 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


1 - No exception shall be thrown. 
resp[] shall contain {0,0,0,3}. 

2 - No exception shall be thrown. 
resp[] shall contain {0,0,3,0}. 
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Id 


Description 


API Expectation 


APDU Expectation 




recOffset = 
respOffset = 
respLength = 
readRecord ( ) 






4 


incr is null 

byte[] nullBuffer = null 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

java.lang.NullPointerException. 




C 

O 


incruiTsei < u 

incrOffset = -1 
respOffset = 
increase ( ) 


onan inrow 
java.lang. 

ArraylndexOutOfBoundsException. 




6 


incrOffset + 3 > incr.length 

incrOffset = 2 
respOffset = 
increase ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




7 


Reach Maximum Value 

incr[0] = incr[l] = incr[2] = ' FF 1 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

MAXVALUEREACHED. 




8 


resp is null 

incr[0] = incr[l] = 0x00' 

incr[2] = '02' 

incrOffset = 

byte[] respNull = null 

respOffset = 

increase ( ) 


Shall throw 

java.lang.NullPointerException. 




Q 

y 


raenOff cot f\ 

incrOffset = 
respOffset = -1 
increase ( ) 


onan inrow 
java.lang. 

ArraylndexOutOfBoundsException. 




10 


respOffset + recordLength > resp.length 

incrOffset = 
respOffset = 2 
increase ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




11 


EF is not Cyclic 

1 - fid = EFTARU 
select ( ) 

z mcrurrseu — u 
respOffset = 
increase ( ) 

3 - fid = EFLARU 
select ( ) 

4 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 
FILEJNCONSISTENT. 




12 


Access condition not fulfilled 

1 - fid = EFCNIC 
select ( ) 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




13 


EF is invalidated 

1 - fid = EFCARU 
select ( ) 

2 - invalidate ( ) 

3 - incrOffset = 
respOffset = 
increase ( ) 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

4 - No exception shall be thrown. 




14 


Check increase not allowed from FCI 

1 - fciOffset = 
fciLength = 8 

select (FID_EF_CINA, fci...) 
Verify FCI byte 8 (fci [7]) 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 
Bit 7 of resp[7] shall not be set (0), 
indicating that increase is not 
allowed. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT 
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CRR Number 

VI II 1 llUlllwCI 


1 C3l vQOv MUIIIUCI 


N1 

IN I 


<-i o 


P1 

1 1 


A 
t 


pp 




1 o 




P4 


7 


P5 


8 


P6 


9 


P7 


10 


C1 


1 


C2 


11 


C3 


14 


C4 


12 


C5 


13 


C6, C7 


Not Tested 



6.1.1.11 Method invalidate 

Test Area Reference: API_1_SVW_INVL 

6.1 .1 .1 1 .1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void invalidate ( ) 

throws SIMViewException 

Normal execution 

CRRN1: The currently selected EF of the calling applet shall be invalidated, i.e. the flag in the EF file status shall be 
changed accordingly. 

Parameter errors 

No requirements. 

Context errors 

CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the calling applet does not fulfil the access condition, INVALIDATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

CRRC3: If the currently selected EF is already invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.11.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 
Test Script: API_l_SVW_INVL_l.scr 
Test Applet: API_l_SVW_INVL_l.java 
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Load Script: API_l_SVW_INVL_l.ldr 
Cleanup Script: API_l_SVW_INVL_l.clr 



6.1.1.11.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF is selected 

1 - invalidate ( ) 


1 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 




2 


Invalidate EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTNR 

select ( ) 

3 — invalidate ( ) 

4 - rehabilitated 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 




3 


Access condition not fulfilled 

1 - fid = EFCNIV 
select () 

2 - invalidate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED. 




4 


EF is already invalidated 

1 - fid = EFTNR 
select () 

2 - invalidate ( ) 

3 - invalidate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 





6.1.1.11.4 Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 



6.1.1.12 Method rehabilitate 

Test Area Reference: API_1_SVW_REHA 
6.1.1.12.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void rehabilitate ( ) 

throws SIMViewException 

Normal execution 

CRRN1: The currently selected EF of the calling applet shall be rehabilitated, i.e. the flag in the EF file status shall 
be changed accordingly. 

Parameter errors 

No requirements. 

Context errors 

CRRC1: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException. NO_EF_SELECTED. 
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CRRC2: If the calling applet does not fulfil the access condition, REHABILITATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

CRRC3: If the currently selected EF is not invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.12.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 
Test Script: API_l_SVW_REHA_l.scr 
Test Applet: API_l_SVW_REHA_l.java 
Load Script: API_l_SVW_REHA_l.ldr 
Cleanup Script: API_l_SVW_REHA_l.clr 



6.1.1.12.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF is selected 

1 - rehabilitate ( ) 


1 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 




2 


Rehabilitate invalidated File 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFCNR 
select ( ) 

3 - invalidate ( ) 

4 - rehabilitate ( ) 

5 - byte[] incr = new byte[3] = {0,0,1} 
incrOffset = 

byte[] resp = new byte[l] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 
resp[] shall contain {0,0,1}. 




3 


Access condition not fulfilled 

1 - fid = EFCNRH 
select ( ) 

2 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED.. 




4 


Rehabilitate validated File 

1 - fid = EFCNR 
select ( ) 

2 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 





6.1.1.12.4 Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 
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6.1.2 Class SI MSystem 
6.1 .2.1 Method getTheSIMView 

Test Area Reference: API_1_SSY_GETS 

6.1.2.1.1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public static SIMView getTheSIMView ( ) 

Normal execution 

CRRN1: returns a reference to class which implements the SIMView interface 

Parameters error 

No requirements 

Context errors 

No requirements 

6.1.2.1.2 Test suite files 

No additional requirements for the GSM personalisation: 
Test Script: API_l_SSY_GETS_l.scr 
Test Applet: API_1_SSY_GETS_1 Java 

Load Script: API_l_SSY_GETS_l.ldr 
Cleanup Script: API_l_SSY_GETS_l.clr 



6.1.2.1.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reference not equal null after execute 


The returned reference shall be not 
null after execute 




2 


reference to the GSM interface 


Returned a reference to the GSM 
interface 





6.1.2.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 



6.1 .3 Class SIMViewException 
6.1.3.1 Method throwlt 

Test Area Reference: API_1_SVE_THITS 
6.1.3.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 
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public static void throwlt (short reason) 
throws SIMViewException 

Normal execution 

CRRN1: Throws the JCRE instance of SIMViewException with the specified reason 
CRRN2: Extends javacard.framework.CardRuntimeException 

Parameter errors 

No requirements 

Context errors 

No requirements 

6.1.3.1.2 Test Suite Files 



No additional requirements for the GSM personalisation 



Test Script: 


API_ 


1. 


_SVE_ 


THITS. 


.l.scr 


Test Applet: 


API_ 


1. 


_SVE_ 


_THITS_ 


.l.java 


Load Script: 


ARI_ 


1. 


_SVE_ 


_THITS_ 


.Lldr 


Cleanup Script: 


API_ 


1. 


_SVE_ 


THITS. 


_l.clr 



6.1.3.1.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 




2 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 15 




4 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 15 





6.1.3.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



6.1.3.2 Constructor 

Test Area Reference: API_l_SVE_COORS 

6.1.3.2.1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public SIMViewException (short reason) 
throws SIMViewException 
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Normal execution 

CRRN1: Construct a SIMViewException with the specified reason 

Parameters error 

No requirements 

Context errors 



No requirements 

6.1.3.2.2 Test suite files 

No additional requirements for the GSM personalisation 



Test Script: 


API_ 


.1. 


_SVE_ 


COORS_l.scr 


Test Applet: 


API_ 


.1. 


_SVE_ 


COORS_l.java 


Load Script: 


API_ 


.1. 


_SVE_ 


COORS.ldr 


Cleanup Script: 


APT. 


.1. 


_SVE_ 


COORS.clr 



6.1.3.2.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


SIMViewException with the specified reason 

(The reason shall set with setReason and 
compare the Exception with getReason) 


Reason (specified) 





6.1.3.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1 



6. 1.3. 3 Reason Codes 

Test Area Reference: API_l_SVE_CONS 

6.1.3.3.1 Conformance Requirement: 

There is no API, only constants. This constants shall compliant to its definition in the API. 
Normal execution 

CRRN1: The Constants of the class SIMViewException shall all have the same name and value defined in the 
GSM03.19 

CRRN2: Constructs SIMViewException a Exception with the specified reason 

Parameters error 

No requirements 

Context errors 

No requirements 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 60 ETSI TS 101 955 V8.0.0 (2002-09) 

6.1.3.3.2 Test suite files 

None 

6.1.3.3.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed 

6.2 Package sim.toolkit 

6.2.1 Interface ToolkitConstants 
6.2.1.1 Constants 

Test Area Reference: API_2_TKC_CONS 

6.2.1.1.1 Conformance Requirement: 

There is no API, only constants. This constants shall be compare to its definition in the API. 
Normal execution 

CRRN1: The Toolkit Constants shall all have the same name and value defined in the GSM03.19 normalization. 

Parameters error 

No requirements 

Context errors 

No requirements 

6.2.1.1.2 Test suite files 

None 

6.2.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.2 Interface Toolkitlnterface 
6.2.2.1 Method processToolkit 

Test Area Reference: API_1_TKI_PRTKB 

6.2.2.1.1 Conformance Requirement: 

The method with following prototype shall compliant to its definition in the API. 

public void processToolkit (byte event) 
throws ToolkitException 

Normal execution 

CRRN1: This interface must be implemented by a Toolkit applet (which extends the javacard.framework. Applet 
class) so that it can be triggered by the Toolkit Handler according to the registration information. 
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CRRN2: The Toolkit applet will have to implement the processToolkit shared method so that the following events 
can be notified: 



Event 


Description 


EVEN! PROr 1L.E IJUWNLUAD 


Terminal Profile command reception 


EVENT_FORMATTED_SMS_PP_ENV 


03.48 formatted envelope SMS-PP Data 
Download reception 


EVENT_FORMATTED_SMS_PP_UPD 


03.48 formatted Update Record EF SMS 


EVENT_UNFORMATTED_SMS_PP_ENV 


Unformatted Envelope SMS-PP Data Download 
reception 


EVENT_UNFORMATTED_SMS_PP_UPD 


II £ ii III 1 i 1— \ 1 I— i— /"\ ■ a/~\ 

Unformatted Update Record EF SMS 


EVENT_UNFORMATTED_SMS_CB 


Unformatted Cell Broadcast Data Download 
command reception 


EVENT_MENU_SELECT ION 


Envelope Menu Selection command reception 


TPJ 7TP "KIT K/TT7 1- hTTT C TP T TP T T f^'hl ZJ TP T T1 T") TP r\ Tl TP C T 1 

EVEN 1 MENU bELEL 1 1(JN HELP RE(J UEb 1 


Envelope Menu Selection Help Request 
command reception 


H V CjIN 1 UA-Li-Lj L.U1N 1 KUii o I olrl 


Envelope Call Control by SIM command 
reception 


FVF T\TT MO QHDR T IvTF QQirP H OKI TROT RY ?TM 
Hi V HjIN ± 1 1\J O nuf\ ±_1 1±j O ^vJlN ± r\vj±i O J. O ±11 


Envelope MO Short Message Control by SIM 

GUI III lieu 1U itjOupLKJII 


EVENT_TIMER_EXP I RAT ION 


Fnvplnnp Timpr Fynirptinn 

1 1 1 V CIUUC 1 1 1 1 Id 1 ALJ 1 1 CI LI U 1 1 


EVENT_EVENT_DOWNLOAD_MT_CALL 


Envelope Event Download - MT call 


EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 


Envelope Event Download - Call connected 


EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 


Event Download - Call disconnected 


EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 


Envelope Event Download - Location status 


EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 


Envelope Event Download - User activity 


EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 


Envelope Event Download - Idle screen available 


EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 


Envelope Event Download - Card Reader Status 


EVENT_STATUS_COMMAND 


Status APDU command event 


EVENT_UNRECOGNIZED_ENVELOPE 


Unrecognized Envelope command reception 



Parameters error 

No requirements 

Context errors 

No requirements 

6.2.2.1.2 Test suite files 

The method is tested in the Framework 

6.2.2.1.3 Test Coverage 



CRR number 


Test case number 


N1 


Tested in Framework 


N2 


Tested in Framework 



6.2.3 Class EditHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EnvelopeResponseHandler, ProactiveHandler. 

6.2.4 Class EnvelopeHandler 
6.2.4.1 Method getEnvelopeTag 

Test Area Reference: API_2_ENH_GENT 
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6.2.4.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getEnvelopeTag ( ) 

Normal execution 

CRRN1: The method shall return the Envelope BER-TLV tag. 

CRRN2: The Envelope BER TAG is available for all triggered toolkit applets from the invocation to the termination 
of their processToolkit method if the EnvelopeHandler is available. 

Parameters error 

Context errors 



6.2.4.1.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.1.3 



Test suite files 

API_2_ENH_GENT_1 .scr 
API_2_ENH_GENT_1 Java 
API_2_ENH_GENT_1 .ldr 
API_2_ENH_GENT_1 xlr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getEnvelopeTag called just after triggering of the 
application. 


Returns 0xD1 




2 


getEnvelopeTag called after a proactive 
command. 


Returns 0xD1 




3 


getEnvelopeTag called after a second proactive 
command. 


Returns 0xD1 





6.2.4.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


1,2,3 



6.2.4.2 Method getltemldentifier 

Test Area Reference: API_2_ENH_GIID 

6.2.4.2.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

Normal execution 

CRRNl:The method shall return the item identifier byte value. 

CRRN2:The item identifier byte value returned shall be from the first Item Identifier TLV element. 
CRRN3: If the element is available it becomes the TLV selected. 
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CRRN4: The item identifier is available for all triggered toolkit applets from the invocation to the termination of 
their processToolkit method if the EnvelopeHandler is available. 

Parameters error 

No requirements. 

Context errors 

CRRC1: The method shall throw ToolkitException (UNAVAILABLE_ELEMENT) if the item identifier TLV is not 
present. 

CRRC2: The method shall throw ToolkitException (OUT_OF_TLV_BOUND ARIES) if the item identifier byte is 
missing in the Item Identifier Simple TLV. 



6.2.4.2.2 Test suite files 



Test Script: 


API_ 


2. 


_ENH_ 


_GIID_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


_ENH_ 


_GIID_ 


_ljava 


Load Script: 


API_ 


2. 


_ENH_ 


_GIID_ 


.Lldr 


Cleanup Script: 


API_ 


_2_ 


_ENH_ 


_GIID_ 


.l.clr 



6.2.4.2.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send envelope SMS-PP Formatted with item 
identifier TLV and identifier value of 03 


Returns 03 




2 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value FF and second 44 


Returns FF 




3 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value 81 and second 44, 
call twice the method getltemldentifier 


Returns 81 
Returns 81 




4 


Send envelope SMS-PP Formatted with item 
identifier TLV and value of 66. FindTLV with TAG 
02. getltemldentifier and then getValueByte with 
offset 


getltemldentifier=getValueByte 




5 


Send envelope SMS-PP Formatted without item 
identifier TLV and getltemldentifier 


ToolkitException 
(UNAVAILABLE ELEMENT) 




6 


Send Envelope SMS-PP Formatted with item 
identifier TLV (66), send proactive command. Then 
getltemldentifier 


Returns 66 




7 


Send Envelope SMS-PP Formatted with item 
identifier TLV but without item number 


ToolkitException 
(OUT_OF_TLV_BOUNDARIES) 





6.2.4.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2, 3 


N2 


2,3 


N3 


4 


N4 


6 


C1 


5 


C2 


7 



6.2.4.3 Method getSecuredDataLength 

Test Area Reference: API_2_ENH_GSDL 
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6.2.4.3.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataLength ( ) 

throws ToolkitException 

Normal execution 

CRRN1: The method shall return the length of the secured data contained in a SMS TPDU TLV. 
CRRN2: The length is from the first SMS TPDU TLV. 
CRRN3: The length should not include padding bytes. 

CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN5: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN6: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 

No requirements 

Context errors 

CRRC1: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.3.2 Test suite files 

Specific triggering: 

- SMS CB 

- FORMATTED SMS PP UPD 

- UNFORMATED SMS PP ENV 

- For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for downloading 
applications. 



Test Script: 


API. 


.2. 


_ENH_ 


_GSDL_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


_ENH_ 


_GSDL_ 


_l.java 


Load Script: 


API. 


_2_ 


_ENH_ 


_GSDL_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_ENH_ 


_GSLD_ 


.l.clr 



6.2.4.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x2A 




2 


Test with TP-OA length of 6 


Returns 0x2A 




3 


Test with TP-OA length of 12 


Returns 0x2A 




4 


Test with RC/CC/DS length of 


Returns 0x10 




5 


Test with RC/CC/DS length of 8 


Returns 0x10 




6 


Test with PCNTR = 


Returns 0x10 
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-7 

1 


\ est Wltn rUN 1 H = / 


rieturns uxuo 




8 


Test with SecuredDataLength = 00 


Returns 0x00 




9 


Test with UserDataLength = 0x33 


Returns 0x33 




10 


Test with UserDataLength = Ox 6C 


Returns Ox 6C 




11 


Test with UserDataLength = Ox 6D 


Returns Ox 6D 




12 


Test with UserDataLength = maximum length: 
0x79 


Returns Ox 79 




13 


Verify it is the first TPDU TLV: 

Send a SMS PP with 2 TPDU TLV and inside two 

different secured data lengths: 5 and 10 


Returns 0x05 




14 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




15 


Same test as 2 but with 
FORMATTED_SMS_PP_UPD 


Returns 0x2A 




16 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




17 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




18 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




19 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




20 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




21 


Same test as 5 but with 

|- /-~\ i-i ft m a - r - - r- 1— r-\ f~\ ft « ft-v ft-v I ■ ft-v r-\ 

FORMATTED SMS PP UPD 


Returns 0x00 




22 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x33 




23 


Same test as 7 but with 
FORMATTED SMS PP UPD 


Returns Ox 6C 




24 


Same test as 8 but with 
FORMATTED SMS PP UPD 


Returns Ox 6D 




25 


Same test as 9 but with 
FORMATTED SMS PP UPD 


Returns Ox 79 




26 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




27 


Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataLength 
and then getValueByte to verify that the current 
TLV is the TPDU TLV 


getValueByte returns 0x40 




28 


Send an envelope SMS CB, 
getSecuredDataLength 


ToolkitException 
UNAVAILABLE ELEMENT 




29 


Send an envelope SMS PP unformatted 


ToolkitException 
UNAVAILABLE ELEMENT 





6.2.4.3.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during 03.48 tests. 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 




11, 12, 13 


N2 


13 


N3 


6, 7 


N4 


1,2,3, 4, 5, 6, 7, 8, 9, 10, 




11,12, 13, 25 


N5 


14, 15, 16, 17, 18, 19, 20, 




21, 22, 23, 24, 25, 26 


N6 


27 


C1 


28 


C2 


29 
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6.2.4.4 Method getSecuredDataOffset 

Test Area Reference: API_2_ENH_GSDO 

6.2.4.4.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataOf f set ( ) 

throws ToolkitException 

Normal execution 

CRRN1: The method shall return the offset of the secured data first byte contained in a SMS TPDU TLV. 
CRRN2: The offset is from the first SMS TPDU TLV. 

CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN5: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 

No requirements 

Context errors 

CRRC1: The method shall thrown ToolkitException (UN A VAIL AB LE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.4.2 Test suite files 

Specific triggering: 

SMS CB 

FORMATTED SMS PP UPD 
UNFORMATED SMS PP ENV 

For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for 
downloading applications. 



Test Script: 


API_ 


_2_ 


ENH 


_GSDO_ 


_Lscr 


Test Applet: 


API. 


2. 


ENH 


_GSDO_ 


_l.java 


Load Script: 


API_ 


_2_ 


ENH 


_GSDO_ 


.l.ldr 


Cleanup Script: 


API_ 


_2_ 


.ENH 


_GSDO_ 


.l.clr 



6.2.4.4.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x21 




2 


Test with TP-OA length of 6 


Returns 0x23 




3 


Test with TP-OA length of 12 


Returns 0x26 




4 


Test with RC/CC/DS length of 


Returns 0x21 




5 


Test with RC/CC/DS length of 8 


Returns 0x29 




6 


Send a SMS PP with 2 TPDU TLV and inside two 
different secured data offsets 


Returns 0x24 ( the first offset ) 
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7 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




8 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns 0x23 




9 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x26 




10 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




11 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x29 




12 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x24 ( the first offset ) 




13 


Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataOffset 

1 I 1 l \ / 1 i-\ J. J. 'I J.I X xl X 

and then getValueByte to verify that the current 
TLV is the TPDU TLV 


Returns 0x40 




1 4 


bend an envelope bMb OB, 
getSecuredDataOffset 


ToolkitException 
UNAVAILABLE ELEMENT 












15 


Send an envelope SMS PP unformatted 


ToolkitException 
UNAVAILABLEELEMENT 




16 


Send an envelope SMS-PP formatted with no 
secured data , getSecuredDataOffset 


Returns 0x21 





6.2.4.4.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during 03.48 tests. 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5, 6, 16 


N2 


6, 12 


N3 


1, 2, 3, 4, 5, 6, 16 


N4 


7, 8, 9, 10, 11 


N5 


13 


C1 


14 


C2 


15 



6.2.4.5 Method getTheHandler 

Test Area Reference: API_2_ENH_GTHD 

6.2.4.5.1 Conformance Requirements 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRN1: The method shall return the single system instance of the EnvelopeHandler class. 

CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime Environment 
(JCRE) Specification [12]) 

Parameters error 

No requirements 
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Context errors 

CRRC1: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 



6.2.4.5.2 Test suite files 



Test Script: 


API. 


_2_ 


_ENH_ 


_GTHD_ 


_l.scr 


Test Applet: 


API_ 


2. 


_ENH_ 


_GTHD_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ENH_ 


_GTHD_ 


Lldr 


Cleanup Script: 


API. 


_2_ 


_ENH_ 


_GTHD_ 


.l.clr 



6.2.4.5.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeHandler 
GetTheHandler 


The reference returned shall be an 
EnvelopeHandler (checkcast) 




3 


Verify the returned value is not null 
GetTheHandler 


The reference returned shall not be 
null. 





6.2.4.5.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in 
Framework tests and 
insert here cross 
reference 


C1 


To be checked in 
Framework tests and 
insert here cross 
reference 



6.2.4.6 Method getTPUDLOffset 

Test Area Reference: API_2_ENH_GTPO 

6.2.4.6.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getTPUDLOf f set ( ) 

throws ToolkitException 

Normal execution 

CRRN1: The method shall return the TPUDL offset in a SMS TPDU TLV. 
CRRN2: The offset is from the first SMS TPDU TLV. 

CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV. 
CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD. 
CRRN5: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_ENV. 
CRRN6: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_UPD. 
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CRRN7: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 

No requirements 

Context errors 

CRRC1: The method shall thrown ToolkitException (UN A VAIL AB LE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNA VAIL AB LE_ELEMENT) if the TPUDL field does not 
exist. 

6.2.4.6.2 Test suite files 

Specific triggering: 

FORMATTED SMS PP UPD 
UNFORMATTED SMS PP UPD 
UNFORMATTED SMS PP ENV 
SMS CB 



Test Script: 


API. 


_2_ 


_ENH_ 


_GTPO_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


_ENH_ 


_GTPO_ 


_l.java 


Load Script: 


API. 


_2_ 


_ENH_ 


_GTPO_ 


_l.ldr 


Cleanup Script: 


API. 


_2_ 


_ENH 


_GTPO_ 


.l.clr 



6.2.4.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x0 D 




2 


Test with TP-OA length of 6 


Returns OxOF 




3 


Test with TP-OA length of 12 


Returns 0x12 




4 


Send a SMS PP with 2 TPDU TLV and inside two 
different UDL offsets 


Returns 0x10 ( the first offset ) 




5 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns OxOD 




6 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns OxOF 




7 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x12 




8 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x10 ( the first offset ) 




9 


Same test as 1 but with 
UNFORMATTED SMS PP UPD 


Returns OxOD 




10 


Same test as 2 but with 
UNFORMATTED SMS PP UPD 


Returns OxOF 




11 


Same test as 3 but with 
UNFORMATTED SMS PP UPD 


Returns 0x12 




12 


Same test as 4 but with 
UNFORMATTED SMS PP UPD 


Returns 0x12 ( the first offset ) 




13 


Same test as 1 but with 

U N FOR MATTE D_S MS_P P_E N V 


Returns OxOD 




14 


Same test as 2 but with 

U N FOR MATTE D_S MS_P P_E N V 


Returns OxOF 




15 


Same test as 3 but with 
UNFORMATTED SMS PP ENV 


Returns 0x12 




16 


Same test as 4 but with 
UNFORMATTED SMS PP ENV 


Returns 0x10 ( the first offset ) 




17 


Verify after call of the method the current TLV is the 
TPDU TLV: 

findTLV device identities, getTPUDLOffset and then 


Returns 0x40 
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getValueByte to verify that the current TLV is the 
TPDU TLV 






18 


Send an envelope SMS CB, getTPUDLOffset 


ToolkitException 
UNAVAILABLEELEMENT 





6.2.4.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 




11, 12, 13, 14, 15, 16, 17 


N2 


4 


N3 


1, 2, 3, 4, 17 


N4 


5, 6, 7, 8 


N5 


13, 14, 15, 16 


N6 


9, 10, 11, 12 


N7 


17 


C1 


18 


C2 


Don't no how to test 



6.2.4.7 Method getLength 

Test Area Reference: API_2_ENH_GLEN 

6.2.4.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRN1: returns the length in bytes of the TLV list. 

Parameter Error 

No requirements 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

6.2.4.7.2 Test Suite files 

Specific triggering: None 

Test Script: API_2_ENH_GLEN_l.scr 
Test Applet: API_2_ENH_GLEN_1 .java 

Load Script: API_2_ENH_GLEN_l.ldr 
Cleanup Script: API_2_ENH_GLEN_l.clr 
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6.2.4.7.3 Test Procedure 



lu 


uescnpiion 


am expectation 


Aruu txpeciaTion 


1 


Send an envelope SMS PP with BER length of 
0x31 


Result of getLength() is 0x0031 




2 


Send an envelope SMS PP with BER length of 
0x7F 


Result of getLength() is 0x007Fh 




3 


Send an envelope SMS PP with BER length of 
81 80 


Result of getLength() is 0x0080h 




4 


Send an envelope SMS PP with BER length of 
81 FC 


Result of getLength() is OxOOFCh 





6.2.4.7.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4 


C1 


Does not apply for 
EnvelopeHandler 



6.2.4.8 Method copy 

Test Area Reference: API_2_ENH_COPY_BSS 

6.2.4.8.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.4.8.2 Test Suite files 

Specific triggering: None 

Test Script: API_2_ENH_COPY_BSS_l.scr 
Test Applet: API_2_ENH_COPY_BSS_l.java 
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Load Script: API_2_ENH_COPY_BSS_l.ldr 
Cleanup Script: API_2_ENH_ COPY _ BSS _1 .clr 



6.2.4.8.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException is 
thrown 




5 


DstOffset + dstLength > dstBuffer.length 

DstBuffer.length = 5 
DstOffset = 3 
DstLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




7 


DstLength > length of the simple TLV list 

DstBuffer.length = 48 
DstOffset = 
DstLength = 48 


ToolkitException.OUT OF TLV BO 
UNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

DstBuffer.length = 47 
DstOffset = 
DstLength = 47 


Result of copy() is 0X0047 




9 


Compare the buffer 


Result of arrayCompare() is 




10 


Successful call, dstBuffer is part of a buffer 

DstBuffer.length = 50 
dstOffset = 3 
dstLength = 47 


Result of copy() is 0X0032 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copy() is 0X0009 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 260 
dstOffset = 257 
dstLength = 3 


Result of copy() is 0X0104 




15 


Compare the whole buffer 


Result of arrayCompareO is 




16 


Successful call, copy with length =0 

dstBuffer.length = 260 
dstOffset = 260 
dstLength = 


Result of copy() is 0x1 04 





6.2.4.8.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13, 15 


N2 


8, 10, 12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 




EnvelopeHandler 
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6.2.4.9 Method findTLV 

Test Area Reference: API_2_ENH_FINDBB 

6.2.4.9.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRN1: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRP1: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.4.9.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.9.3 



API_2_ENH_ENH_FINDBB_1 .scr 
API_2_ENH_ENH_FINDBB_1 Java 
API_2_ENH_ENH_FINDBB_1 .ldr 
API_2_ENH_FINDBB_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Trig the applet with SMS PP including one more 
tag 02 and one TAG 04 






1 


Invalid input parameter 

Occurrence = 


ToolkitException. BAD_INPUT_P 
ARAMETER is thrown 




2 


Search 1st TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLength() method 


Result is 0x02 




4 


Search 2nd TLV 

Tag = 06h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 
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5 


Call the getValuel_ength() method 


Result is 0x05h 




6 


Select a TLV (tag 02h) 






Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLVNOTFOUND 




7 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = 02h 
Occurrence = 3 


Result is TLV NOT FOUND 




9 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown. 




10 


Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 

Tl \/ F(~ll IMn PR MOT QCT 
1 l_V r^UINL/ Kjr\ W\J 1 oC 1 




11 


Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 

TLV FOUND CR NOT SET 




12 


Search tag 81 h 

Tag = 86h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 





6.2.4.9.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5 


N2 


2, 4 


N3 


10, 11 


N4 


6,7,8,9 j 


N5 


12, 13 


P1 


1 


C1 


Does not apply for 




EnvelopeHandler 



6.2.4.10 Method getValueLength 

Test Area Reference: API_2_ENH_GVLE 
6.2.4.10.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRN1: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 
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6.2.4.10.2 Test Suite files 



Specific triggering: None 



Test Script: 


API_ 


_2_ 


ENH 


_GVLE_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


ENH 


_GVLE_ 


_l.java 


Load Script: 


API. 


_2_ 


ENH 


_GVLE_ 


_l.ldr 


Cleanup Script: 


APT. 


_2_ 


ENH 


_GVLE_ 


.l.clr 



6.2.4.10.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 






1 


getValueLength() 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueLength ( ) 


Result is 0X0002 




3 


Search TLV OBh 








getValueLength ( ) 


Result is 0X0024 




4 


Search TLV 33h 








getValueLength ( ) 


Result is 0X00C8 





6.2.4.10.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4 


C1 


Does not apply for 
EnvelopeHandler 


C2 


1 



6.2.4.1 1 Method getValueByte 

Test Area Reference: API_2_ENH_GVBYS 
6.2.4.11.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte ( short valueOffset) 
throws ToolkitException 

Normal execution 

CRRN1: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRP1: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 
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6.2.4.11.2 Test Suite files 



Specific triggering: None 



Test Script: 


API_ 


_2_ 


ENH 


.GVBY.scr 


Test Applet: 


API_ 


_2_ 


ENH 


_GVBY_l.java 


Load Script: 


API. 


_2_ 


ENH 


.GVBY.ldr 


Cleanup Script: 


APT. 


_2_ 


ENH 


GVBY_l.clr 



6.2.4.1 1 .3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 
Value 01 02 ... 






1 


getValueByte(O) 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




2 


Search TLV 02h 








getValueByte (2) 


ToolkitException. OUT OF TLV_ 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueByte (1) 


Result is 0x81 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 83h (Source) 




5 


Search TLV 33h 








getValueByte (7E) 


Result is 0x7F 




6 


Search TLV 33h 








getValueByte (80) 


Result is 0x81 




7 


getValueByte (7F) 


Result is 0x80 




8 


Search TLV B3h 








getValueByte (C7) 


Result is 0xC8 





6.2.4.11.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 




EnvelopeHandler 


C2 


1 



6.2.4.12 Method copyValue 

Test Area Reference: API_2_ENH_CPYVS_BSS 
6.2.4.12.1 Conformance Requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitException 

Normal execution 

CRRN1: copies a part of the last TLV element which has been found, into a destination, buffer. 
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CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.12.3 Test Suite files 

Specific triggering: None 
Test Script: 



Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.12.3 



API_2_ENH_CPY VS_BSS_1 .scr 
API_2_ENH_CPYVS_BSS_1 .java 
API_2_ENH_CPYVS_BSS_1 .ldr 
API_2_ENH_CPYVS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer. length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 
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dstLength = 1 






9 


dstLength > TLV length 

valueOffset = 

HcfRnf for 1 onnl-h — 1 R 

dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > TLV length 

valueOffset = 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 








copyValue ( ) 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown on the 
copyValue() method 




12 


Search TLV 06h 








Successful call 


Result of copyValue() is 0x0006 






valueOffset = 








dstBuff er . length = 6 








dstOffset = 








dstLength = 6 






13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 1 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of copyValue() is 0x0007 






valueOffset = 1 








dstBuff er . length = 20 








QSCUllScC — o 








dstLength = 4 






15 


Compare buffer 

buffer = 

cc cc cc -1-1 99 

■~J -~J ^J^J ^J^J -L-L 

33 44 55 55 55 
55 55 55 55 55 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copy with length =0 

dstBuff er . length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueQ is 20 





6.2.4.12.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeHandler 


C2 


11 



6.2.4.13 Method compareValue 

Test Area Reference: API_2_ENH_CPRVS_BSS 
6.2.4.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue ( short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitException 
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Normal execution 

Compares the last found TLV element with a buffer: 
CRRN1: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.13.3 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


_2_ 


ENH 


_CPRVS_ 


_BSS_ 


_l.scr 


Test Applet: 


API_ 


2. 


ENH 


_CPRVS_ 


_BSS_ 


l.java 


Load Script: 


API_ 


_2_ 


.ENH 


_CPRVS_ 


_BSS_ 


l.ldr 


Cleanup Script: 


API_ 


_2_ 


ENH 


_CPRVS_ 


_BSS_ 


l.clr 



6.2.4.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








compareValue ( ) with a null compareBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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compareOf f set = 
compareLength = -1 






7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
compar eBu f fer . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV ' 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compar eBu f fer . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > TLV length 

valueOffset = 
compareBuf fer . length = 15 
compar eOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > TLV length 

valueOffset = 2 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 


Result is TLV NOT FOUND 




compareValue ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


Search TLV 06h 








Initialise compareBuffer 

compareBuf fer = 
81 11 22 33 44 F5 








Compare buffers 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




13 


Initialise compareBuffer 

compareBuffer = 
7F 11 22 33 44 F5 






Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
83 11 22 33 44 F5 






Compare buffers with same parameters 


Result is -1 




I 


iniLldllbc LumpdicDU 1 lei 

compareBuffer = 

55 55 55 81 11 22 33 44 F5 

55 55 55 55 55 








oompare uuners 

valueOffset = 1 
compareOf f set = 4 
compareLength = 5 


riesuii is uun 




16 


Initialise compareBuffer 

compareBuffer = 

55 55 55 81 10 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




17 


Initialise compareBuffer 

compareBuffer = 

55 55 55 81 12 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




18 


Successful call, compareValue with length =o 

CompareBuf fer . length = 15 
CompareOf f set = 15 
CompareLength = 


Result of compareValue() is 
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v^nn iiuiiiucri 


1 COl l/d3C IIUIIIUCI 


N1 


12, 15 


N2 


13, 16, 18 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeHandler 


C2 


11 



6.2.4.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) 

Test Area Reference: API_2_ENH_FACYB_BS 
6.2.4.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 

short dstOffset) 
throws java . lang . NullPointerException, 
java . lang . Array IndexOutOf BoundsExcept ion, 

Toolkit Except ion 

Normal execution 

CRRN1: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UN A VAIL AB LE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AV AIL ABLE. 

6.2.4.14.3 Test Suite files 



Specific triggering: None 



Test Script: 


API_ 


_2_ 


_ENH_ 


FACYB_ 


_BS_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


_ENH 


_FACYB_ 


_BS_ 


_l.java 


Load Script: 


API, 


_2_ 


ENH 


FACYB_ 


_BS_ 


Lldr 


Cleanup Script: 


API_ 


_2_ 


ENH 


_FACYB_ 


_BS_ 


.l.clr 
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6.2.4.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02... 






1 


FindAndCopyValue() with a null dstBuffer 


NullPointerException is thrown 




d. 


dstuttset > astDUtter. length 

tag = 06h 

dstBuff er . length = 06 
dstOffset = 06 


Array inaexuuiurBounastxcepiio 
n is thrown 




o 
o 


H«stOff<spt f n 

dstBuff er . length = 06 
dstOffset = -1 


Ml I ay li IUcaUULUI DUUI lUbrZAOUpilU 

n ic thrn\A/n 
it lb Li li uwi I 




4 


length > dstBuffer. length 

dstBuff er . length = 05 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

DstBuff er . length = 06 
DstOffset = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCopyValue() 

tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 







Call the getValueLengthQ method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




7 


Successful call 

iciy — u on 

DstBuff er . length = 06 
DstOffset = 


Result of findAndCopyValue () is 

UUUb 




8 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

QSLtiurrer . leny in — ±z 
dstOffset = 2 


Result of findAndCopyValue () is 

UUUo 




1 n 


f^nmrmfo Hiiff«*r 

buffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 


Dooi lit ic nnh 

ricbUIL lb uuil 




1 1 


Successful call 

tag = 02h 
dstOffset = 


Result or rindAndOopyvalue () is 
0002 




12 


Compare buffer 

buffer = 83 81 


Result is OOh 




H O 

1 3 


Successful call (with tag 82h) 

tag = 82h 

dstBuff er . length = 02 
dstOffset = 


Result or rindAndOopyvalue () is 
0002 




14 


Compare buffer 

buffer = 83 81 


Result is OOh 




15 


Successful call (with tag B3h) 

tag = B3h 

dstBuffer . length = C4 
dstOffset = 


Result of findAndCopyValue () is 
00C4 




16 


Compare buffer 

buffer = 01 02 ... C4 


Result is OOh 
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CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




EnvelopeHandler 



6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: API_2_ENH_FACYBS_BSS 
6.2.4.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.4.15.3 Test Suite files 

Test Script: API_2_ENH_FACYBS_BSS_l.scr 
Test Applet: API_2_ENH_FACYBS_BSS_l.java 
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Load Script: API_2_ENH_FACYBS_BSS_l.ldr 
Cleanup Script: API_2_ENH_FACYBS_BSS_l.clr 



6.2.4.15.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCopyValue() with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer. length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = —1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


T" II "1.1 — . i! IT /""\ 1 — T"l \l 

ToolkitException. OUT_OF_TLV_ 
BOUNDARIES is thrown 




9 


dstLength > Value length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV_ 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Select a TLV (tag 02h) 








findAndCopyValue() 

tag = 06h 
occurrence = 2 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




12 


Successful call 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 06 
dstOffset = 
dstLength = 06 


Result of findAndCopyValue() is 
6 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

tag = 06h, occurrence = 1 
valueOffset = 2 


Result of findAndCopyValue () is 
0007 
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dstBuffer . length = 12 
dstOffset = 3 
dstLength = 04 






15 


Compare buffer 

buffer = 

55 55 55 22 33 44 F5 55 55 55 55 55 


Result is OOh 




1 


Cl IP^QCcf 1 1 1 O 1 1 

OULLcbblUI Call 

tag = 02h, occurrence = 1 
valueOffset = 
dstBuffer . length = 12 
dstOffset = 
dstLength = 2 


riesuii or Tinartnaoopy vciiueij is 
0002 




1 / 


v_»ornpdic Duller 

buffer = 83 81 55 ... 55 


riesuii is uun 




1 Q 
\ O 


ouccessTui can 

tag = 02h, occurrence = 2 
valueOffset = 
dstBuffer . length = 12 
dstOffset = 
dstLength = 2 


riesuii or nnuAnaL'Opy vaiue() is 
0002 




19 


Compare buffer 

buffer = zz 44 55 ... 55 


Result is OOh 




20 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 1 
valueOffset = 
dstBuff er . length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




21 


Compare buffer 

Duffer — o3 ol 55 ... 55 


Result is OOh 




22 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 2 
valueOffset = 
dstBuffer . length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




23 


Compare buffer 

Buffer = 22 44 55 ... 55 


Result is OOh 




24 


Successful call, findAndCopyValue with 
length =0 

DstBuffer . length = 12 
dstOffset = 12 
dstLength = 


Result of findAndCopyValue () is 
12 





6.2.4.15.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18, 24 


N4 


20, 21, 22, 23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeHandler 



6.2.4.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ENH_FACRB_BS 
6.2.4.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 
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public byte f indAndCompareValue (byte tag, 

byte[] compareBuf f er, 
short compareOf f set ) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRN1: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 



6.2.4.16.3 Test Suite files 



Test Script: 


API_ 


2. 


_ENH_ 


_FACRB_ 


_BS_ 


_Lscr 


Test Applet: 


API. 


_2_ 


ENH 


_FACRB_ 


_BS_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ENH 


_FACRB_ 


_BS_ 


.l.ldr 


Cleanup Script: 


API_ 


2. 


ENH 


_FACRB_ 


_BS_ 


.l.clr 



6.2.4.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = 06h 

compareBuffer.length = 12 
compareOffset = 12 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 12 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 05 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length = 12 
compareOffset = 7 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 
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findAndCompareValue() 

tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown. 




7 


Initialise compareBuffer 

compareBuf fer = 81 11 22 33 44 F5 








Compare buffers 

tag = 06h 
compareOf f set = 


Result is OOh 










8 


Verify current TLV 

getValueLength ( ) 


Result is 06 




9 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




10 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




11 


Initialise compareBuffer 

compareBuffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




12 


Initialise compareBuffer 

compareBuffer = 

55 55 83 81 55 55 55 55 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




13 


Initialise compareBuffer 

compareBuffer = 

55 55 83 80 55 55 55 55 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is +1 




14 


Initialise compareBuffer 

compareBuffer = 

55 55 83 82 55 55 55 55 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is -1 




15 


Initialise compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

tag = 02h 

compareBuf fer . length = 12 
compareOf f set = 


Result is OOh 






Initialise compareBuffer 

CompareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

Tag = B3h 

CompareBuf fer . length = C4 
CompareOf f set = 


Result is OOh 





6.2.4.16.4 Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


N6 


15,16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




EnvelopeHandler 
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6.2.4.1 7 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: API_2_ENH_FACRBBS_BSS 
6.2.4.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRN1: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.4.17.3 Test Suite files 



Test Script: 


API_ 


2. 


_ENH_ 


_FACRBBS_ 


_BSS_ 


_lscr 


Test Applet: 


API. 


_2_ 


ENH 


_FACRBBS_ 


_BSS_ 


_l.java 


Load Script: 


API_ 


_2_ 


ENH 


_FACRBBS_ 


_BSS_ 


.l.ldr 


Cleanup Script: 


API_ 


_2_ 


.ENH 


_FACRBBS_ 


_BSS_ 


.l.clr 
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6.2.4.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 








Tag 33, Length C4 Value 01 02... 






1 


findAndCompareValue() with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
compareBuffer.length = 6 
compareOffset = 6 
compareLength = 1 


Array IndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 6 
compareOffset = -1 

K, UlUj-J a. _L fcr J_i til iy L, 1 1 — ± 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 

UlLLjy & _L trJ_i til iy U 1 1 — O 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Value length 

valueOffset = 
c omp areBuffer. length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Value length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES iq thrown 

UVUI NLyrVI 111 v_> IO LI II UvVI 1 




11 


Invalid parameter 

occurrence = 


ToolkitException . BADJ NPUTP 
ARAMETER is thrown 




12 


Select a TLV (tag 02h) 








findAndCompareValue() 

tag = 06h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






occurrence = 2 








Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT iq thrown 

1 l_ 1 1 V 1 1— IM 1 IO LI II WW 1 1. 




13 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








findAndCompareValue() 


Rpci i|t iq OOh 

1 IUOUI L IO WWI 1 






tag = 06h, occurrence = 1 








valueOffset = 








compareOffset = 
compareLength = 6 






14 


Verify current TLV 

getValueLength ( ) 


Result is 0006 




15 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




16 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F6 
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Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuf f er = 

55 55 55 22 33 44 F5 55 55 55 55 








Compare buffers 


Result is OOh 






valueOffset = 2 








compareOf f set = 3 








compareLength = 4 






18 


Initialise compareBuffer 

compareBuffer = 

55 55 55 22 33 45 F5 55 55 55 55 









Compare buffers with same parameters 


Result is -1 




19 


Initialise compareBuffer 

compareBuffer = 

55 55 55 22 33 43 F5 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




on 


iniLldllbc OUfUpdlcDUIIci 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








TinuMnairOinpare vaiue^ 


D0.011I+ io Afll-* 

riesuii is uun 






tag = 02h, occurrence = 1 








v?i 1 npof f qpt = n 
















compareLength = 2 






c. \ 


iniudiibc uumpdi cdui icr 

compareBuffer = 

22 44 55 55 55 55 55 55 55 55 55 55 








TinuMnairO ill pare vaiuey 


riesuii is uun 






tag = 02h, occurrence = 2 








valueOffset = 








compareOf f set = 








compareLength = 2 






00 
d-d. 


iniudiibt? ounipdrcDui ici 

compareBuffer = 

22 45 55 55 55 55 55 55 55 55 55 55 








TinuMnairOiTipare valuer 


Result is -1 






tag = 02h, occurrence = 2 








17a 1 nofif f c;pt- = 








1 L L kJ al Cvl 1 OC L — \J 








compareLength = 2 






00. 


imudiibt? oompdr cdui icr 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Cl l^nnnnf 1 || n n 1 1 /lHfl+Ut to/1 ftOll\ 

ouccessTui call {wiin lag u^nj 


riesuii is uun 






tag = 02h, occurrence = 1 








VCl-lUCvllOCL — w 








rnnrna rpRn f f pr 1 ^nrr"r"Vi = 19 

{J 1 L L kJ Cl -L CD U L 1 Cl a ±C11m Lit — 1 i 








compareOf f set = 








K^KJIY L kJ al CIiCIIm Lii — ^ 






OA 


iniiiaiise cornpareDUTTer 

compareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 


Result is OOh 






tag = B3h, occurrence = 1 








valueOffset = 








compareBuf fer . length = 00C4 








compareOf f set = 








compareLength = 00C4 






25 


Successful call, findAndCompareValue with 
length =0 

DstBuf fer . length = C4 
DstOffset = C4 
DstLength = 


Result of findAndCompareValue() 
is OOh 
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6.2.4.17.4 Test Coverage 



CRR numhpr 

VI II 1 1 IUIIIUCI 


Tp^t rasp numhpr 

1 C3I UQOC IIUIIIUCI 


N1 

IN I 


1 c. 


I N C. 


1 A 
1 1 


I NO 


n 17 ?o ?1 


N4 


19, 15 


N5 


16, 18, 22 


N6 


23, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


L P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




EnvelopeHandler 



6.2.5 Class EnvelopeResponseHandler 
6.2.5.1 Method getTheHandler 

Test Area Reference: API_2_ERH_GTHD 

6.2.5.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeResponseHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRN1: The method shall return the single system instance of the EnvelopeResponseHandler class. 

CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]) 

Parameter errors 

No requirements 

Context errors 

CRRC1: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 

CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no more 
available 

6.2.5.1.2 Test suite files 

Test Script: API_2_ERH_GTHD_l.scr 

Test Applet: API_2_ERH_GTHD_1 j ava 

Load Script: API_2_ERH_GTHD_l.ldr 

Cleanup Script: API_2_ERH_GTHD_l.clr 
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6.2.5.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeHandler 

getTheHandler 


The reference returned shall be an 

EnvelopeResponseHandler 

(checkcast) 




3 


Verify the returned value is not null 

getTheHandler 


The reference returned shall not be 
null. 




4 


getTheHandler, then send a proactive 
command, and then, appendTLV 


ToolkitException 

HANDLER NOT AVAILABLE is 

thrown 





6.2.5.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in 
Framework tests and 
insert here cross 
reference 


C1 


To be checked in 
Framework tests and 
insert here cross 
reference 


C2 


4 



6.2.5.2 Method post 

Test Area Reference: API_2_ERH_POSTB 

6.2.5.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void post (byte statusType) 
throws ToolkitException 

Normal execution 

CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command). 

CRRN2: The byte statusType is SW1 of the status. 

CRRN3: If the send method is called after a post method, the posted data are the first sent to the ME. 

CRRN4: The SIM Toolkit Framework shall take the optional Application Data posted by the triggered toolkit applet 
if present, secure and send the response packet the SIM Toolkit Framework will return the response APDU 
defined by the toolkit applet. 

Parameter error 

No requirements 

Context errors 

CRRC1: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 

6.2.5.2.2 Test suite files 

Specific triggering: Call control 
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Test Script: 


API. 


.2. 


_ERH_ 


.POSTB. 


.l.scr 


Test Applet: 


API_ 


_2_ 


_ERH_ 


.POSTB. 


.l.java 


Load Script: 


API. 


_2_ 


_ERH_ 


.POSTB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


_ERH_ 


.POSTB. 


.l.clr 



6.2.5.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then post 

(the handler is empty) 




9000 


2 


Fill the handler ( appendTLV to have bytes 

in it ) and then post data with status 
9F 




9FFD data are retrieved with GET 
RESPONSE command 


3 


Verify that after a post the handler is no 
more available 

appendTLV, post and then appendTLV 


ToolkitException 
HANDLE R_N OT_A V A I L A B L 
E is thrown on the second 
appendTLV 




4 


construct the response (appendTLV with 
0x10 data) and post it with status 9E and 
then send a display text 




9E1 2 and posted data retrieved by a 
GET RESPONSE with status 91 1 3 
and display text retrieved by a FETCH 


5 


Verify that it is possible to send a proactive 
command after a post 

getTheHandler and post , then send a 
display text 




91 13 and display text is retrieved by 
a FETCH 


6 


Verify it is not possible to post after a 
proactive command 

getTheHandler, appendTLV, send a 
display text, post. 


ToolkitException 

HANDLE R_N OTA V A I L A B L 

E is thrown 




7 


Verify that the handler is no more available 
after a post 

getTheHandler, appendTLV, post with 
status 9E, post with status 9F 


ToolkitException 

HANDLE R_N OTA V A I L A B L 

E is thrown 


9E1 2 and posted data retrieved by a 
GET RESPONSE 



6.2.5.2.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 7 


N2 


1, 2, 4, 7 


N3 


4, 5 


N4 


To be checked in 




Framework tests and 




insert here cross 




reference 


C1 


6 



6.2.5.3 Method postAsBERTLV 

Test Area Reference:API_2_ERH_POSTBB 
6.2.5.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void postAsBERTLV (byte statusType, 

byte tag) 
throws ToolkitException 

Normal execution 

CRRN1: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command) the SIM Toolkit Framework will return the response APDU defined by the toolkit applet. 
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CRRN2: The byte statusType is SW1 of the status 

CRRN3: If the send method is called after a postAsBERTLV method, the posted data are the first sent to the ME. 
CRRN4: The byte tag is the BER Tag at the beginning of the simple TLV list. 

Parameter errors 

No requirements 

Context errors 

CRRC1: The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy. 
6.2.5.3.2 Test suite files 



Specific triggering: Call control 



Test Script: 


API_ 


2. 


ERH 


_POSTBB_ 


l.scr 


Test Applet: 


API, 


_2_ 


_ERH 


_POSTBB_ 


.l.java 


Load Script: 


API. 


_2_ 


ERH 


_POSTBB_ 


.l.ldr 


Cleanup Script: 


APT 


2. 


.ERH 


_POSTBB_ 


l.clr 



6.2.5.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then postAsBERTLV 

(the handler is empty) 




9F02 data are retrieved with 
GET RESPONSE command, 
the tag shall be 33 and the 
length is 00 


2 


Fill the handler and then postAsBERTLV 
the data with status 9F, and tag 33 




9FFF data are retrieved with 
GET RESPONSE command, 
the tag shall be 33 


3 


appendTLV, postAsBERTLV and then 
appendTLV 


ToolkitException 
HANDLERNOTAVAILABLE is 
thrown on the second appendTLV 




4 


construct the response (appendTLV with 

0x10 data) and postAsBERTLV it with 
status 9E, tag 75 and then send a display 
text 




9E14 and posted data 
retrieved by a GET 
RESPONSE the tag shall be 
75 with status 91 13 and 
display text retrieved by a 
FETCH 


5 


getTheHandler and postAsBERTLV, then 
send a display text 




9E02 and posted data 
retrieved by a GET 
RESPONSE the tag 33 (and 
the length 00) with status 
91 13 and display text is 
retrieved by a FETCH 


6 


Verify it is not possible to postAsBERTLV 
after a proactive command 

getTheHandler, appendTLV, send a 
display text, postAsBERTLV. 


ToolkitException 
HANDLER NOT AVAILABLE is 
thrown on the postAsBERTLV 




7 


Verify that the handler is no more available 
after a postAsBERTLV 

getTheHandler, appendTLV (with data 
length = 0x10, postAsBERTLV with status 
9E, tag 56, postAsBERTLV with status 
9F, tag 28 


ToolkitException 
HANDLER NOT AVAILABLE is 
thrown on the second postAsBERTLV 


9E14 and posted data 
retrieved by a GET 
RESPONSE the tag shall be 
56 with status 9000 
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6.2.5.3.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 7 


N2 


1, 2, 4, 7 


N3 


4, 5 


N4 


2,4,7 


C1 


6 



6.2.5.4 Method getLength 

Test Area Reference: API_2_ERH_GLEN 
6.2.5.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRN1: returns the length in bytes of the TLV list. 

Parameter errors 

No requirements 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_A VAIL ABLE. 

6.2.5.4.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


_2_ 


ERH 


_GLEN_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


ERH 


_GLEN_ 


_l.java 


Load Script: 


API_ 


_2_ 


.ERH 


_GLEN_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


.ERH 


_GLEN_ 


.l.clr 



6.2.5.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLength() is 




2 


appendTLV with length of 7 

getLength ( ) 


Result of getLength() is 9 




3 


Clear the handler and appendTLV with Length 
of 250 

getLength ( ) 


Result of getLength() is 253 




4 


Build a 7Fh Envelope response handler 

getLength ( ) 


Result of getLength() is 81 h 




5 


Build a 80h Envelope response handler 

getLength ( ) 


Result of getLength() is 83h 





Note : Test case 3 is limited to 253 and not 256 because the current 03.19 [7] is not clear enough on this point. So this 
test allows the two possible implementations. 
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6.2.5.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5 


C1 


Does not apply for 
Envelope response 
handler 



6.2.5.5 Method copy 

Test Area Reference: API_2_ERH_COPY_BSS 
6.2.5.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is greater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.5.5.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_COPY_BSS_l.scr 
Test Applet: API_2_ERH_COPY_BSS_l.java 
Load Script: API_2_ERH_COPY_BSS_l.ldr 
Cleanup Script: API_2_ERH_COPY_BSS_l.clr 
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6.2.5.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with value length of 7 
NULL as Darameter to dstBuffer 


Ni illPnintprFyrpntinn thrown 

M U II 1 Will LV-/ 1 ^Avwk/LI Ul 1 IO LI II U Vvl 1 




2 








dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
ds t Lsncj t h = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 
dstOffset = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




a 

o 


Siirrp^^fiil r*all H^tRuffpr thp whnlp huffpr 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Rp<?iilt nf nnnvM i<5 Q. 
ncoUiL \J\ \j\jyjy y) 10 Z/ 




Q 


Hnmnarp thp huffpr 


Rp<?iilt nf arr;i\/f^nmnarpn \o. 




1 n 


^iiffpc^ful r*all HctRuffpr ic nart nf a huffpr 

UUljl/COSlUI l#CIII, U31DUMCI 1 d 1 I Ul CI UUIICI 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Doci ilt nf nr\!Ti\f(\ ic 1 
ncoUll Ul \j\j\Jy\) lo \ C- 




1 1 


Compare the whole buffer 


RGSult of airayCornpare() is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copy() is 9 




13 


Compare the whole buffer 


Result of arrayCompare() is 




14 


Successful call, copy with length =0 

dstBuffer.length = 15 
dstOffset = 15 
dstLength = 


Result of copy() is 15 





6.2.5.5.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 




Envelope response 




handler 



6.2.5.6 Method findTLV 

Test Area Reference: API_2_ERH_FIND B B 
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6.2.5.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRN1: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRP1: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException B AD_INPUT_P AR AMETER . 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.5.6.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API_ 


_2_ 


ERH 


_FINDBB_ 


_l.scr 


Test Applet: 


API. 


2. 


ERH 


FINDBB. 


_l.java 


Load Script: 


API. 


_2_ 


ERH 


FINDBB. 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


ERH 


_FINDBB_ 


.l.clr 



6.2.5.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Invalid input parameter 

Occurrence = 


ToolkitException . BADJ NPUTP 
ARAMETER is thrown 




2 










Search 1st TLV 


Result is TLV_FOUND_CR_SET 






Tag = Olh 








Occurrence = 1 






3 


Call the getValueLength() method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLength() method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 


Result is TLV NOT FOUND 
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Tag = 03h 








Occurrence = 1 






7 


Call the getValuel_ength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 
Occurrence = 2 


Result is TLVNOTFOUND 




9 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 


Result is 






Tag = 02h 


TLV_FOUND_CR_NOT_SET 






Occurrence = 2 






11 


Append a TLV with tag=04h 








Search the TLV 


Result is 






Tag = 04h 


TLV FOUND CR NOT SET 






Occurrence = 1 






12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 





6.2.5.6.4 Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


L N5 


12, 13 


P1 


1 


C1 


Does not apply for 




Envelope response 




handler 



6.2.5.7 Method getValueLength 

Test Area Reference: API_2_ERH_GVLE 
6.2.5.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRN1: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 
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6.2.5.7.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API_ 


2. 


_ERH_ 


_GVLE_ 


T.scr 


Test Applet: 


API. 


.2. 


_ERH_ 


_GVLE_ 


T-java 


Load Script: 


API. 


.2. 


_ERH_ 


_GVLE_ 


.l.ldr 


Cleanup Script: 


API. 


2. 


_ERH_ 


_GVLE_ 


.l.clr 



6.2.5.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 02 02 02 02 
findTLV with TAG 03 






getValueLength() 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




2 


appendTLV with TAG 0D and length 00 








Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Clear the handler and append TLV with TAG 
0D and length 02 








Search TLV ODh 








getValueLength ( ) 


Result is 02h 




4 


Clear the handler and append TLV with TAG 
OD and length 0x7F 






Search TLV ODh 








getValueLength() 


Result is 7Fh 




5 


Clear the handler and append TLV with TAG 
OD and length 0x80 








Search TLV ODh 








getValueLength ( ) 


Result is 80h 




6 


Clear the handler and append TLV with TAG 
OD and length 0xF1 








Search TLV ODh 








getValueLength ( ) 


Result is F1h 





6.2.5.7.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 


C2 


1 



6.2.5.8 Method getValueByte 

Test Area Reference: API_2_ERH_GVBYS 
6.2.5.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte ( short valueOffset) 
throws ToolkitException 
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Normal execution 

CRRN1: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRP1: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES . 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.8.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API_ 


_2_ 


ERH 


_GVBYS_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


ERH 


_GVBYS_ 


l.java 


Load Script: 


API_ 


_2_ 


ERH 


_GVBYS_ 


Lldr 


Cleanup Script: 


API_ 


2. 


.ERH 


_GVBYS_ 


l.clr 



6.2.5.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 82 02 81 82, appendTLV 81 03 1 1 
22 FE 
findTLV with TAG 03 








getValueByte (0) 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




2 


Search TLV 01 h 








getValueByte (3) 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h 








getValueByte (2) 


Result is FEh 




4 


Search TLV 02h 








getValueByte (0) 


Result is 81 h 




5 


appendTLV with TAG 0D, Length 0x7E, Value: 
00, 01,..., 7D 








getValueByte (7D) 


Result is 7Dh 




6 


clear the handler, appendTLV with TAG 0D, 
Length 0x80, Value: 00, 01, 7F 








getValueByte (7E) 


Result is 7Eh 




7 


getValueByte (7F) 


Result is 7Fh 




8 


clear the handler, appendTLV with TAG 0D, 
Length 0xF1, Value: 00, 01, F0 








getValueByte (F0) 


Result is FOh 
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6.2.5.8.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 


C2 


1 



6.2.5.9 Method copyValue 

Test Area Reference: API_2_ERH_CPYVS_BSS 
6.2.5.9.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.9.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_CPYVS_BSS_l.scr 
Test Applet: API_2_ERH_CPYVS_BSS_l.java 
Load Script: API_2_ERH_CPYVS_BSS_l.ldr 
Cleanup Script: API_2_ERH_CPYVS_BSS_l.clr 
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6.2.5.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: 0D and length 16 
Select Text String TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer. length 

dstBuffer.length = 5 
dstOffset = 

<_Lo L J_i til ly U 1 1 — o 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler, appendTLV with TAG: 0D 
and length 6 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


T" ii. — . j.: /~\i it /""\ i — ti \/ 

ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 

t~t /"\ i i h i r~\ a i — * ii — i~i ■ j.i 

BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








copyValue ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


clear the handler, appendTLV with TAG: 0D 
and value: 04 00 01 ... OF 
Select Text String TLV 








^urrp^^ful rail 

valueOffset = 
dstBuffer.length = 17 
dstOffset = 
dstLength = 17 






13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 
dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValue() is 15 
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15 


Compare buffer 

buffer = 

ss ss ss m n? 

JJ JJ JJ u± uz 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copyValue with length =0 

dstBuffer . length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueQ is 20 





6.2.5.9.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 


C2 


11 



6.2.5.10 Method compareValue 

Test Area Reference: API_2_ERH_CPRVS_BSS 
6.2.5.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue ( short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

Compares the last found TLV element with a buffer: 
CRRN1: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 
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CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.10.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


_2_ 


_ERH 


_CPRVS_ 


_BSS_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


ERH 


_CPRVS_ 


_BSS_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ERH 


_CPRVS_ 


_BSS_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


.ERH. 


_CPRVS_ 


_BSS_ 


.l.clr 



6.2.5.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: 0D and length 16 
Select Text String TLV 








romnarpValnpn with a null romnarpRuffpr 


Ni illPnintprFyrpntinn 19 thrnwn 

INUIII Ull IICI 1 AOC kJ 1 1 \J 1 1 IO LI 1 1 W VV 1 1 




d. 










compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = - 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: 0D and length 6 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 6 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 






compareBuffer.length = 15 








compareOffset = 








compareLength = 1 






8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








compareValue ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


appendTLV with TAG: 0D and value: 04 00 01 
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... OF 








Select Text String TLV 








Initialise compareBuffer 








compareBuffer = 
04 00 01 ... OF 









Compare buffers 


Result is OOh 






valueOffset = 








compar eOf f set = 








compareLength = 17 






13 


Initialise compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA 0B 0C 0D 
0E 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




-I 

I 


1 n i -f i o 1 i o o frtmnaKoRi iffar 

imudiibc ournpdrcDui ler 

compareBuffer = 
cc cc cc ni no 

J J DO DO UI UZ 

03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 









Compare buffers 

valueOffset = 2 


Result is OOh 






compar eOf f set = 3 
compareLength = 12 






16 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA 0D 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 J 




18 


Successful call, compareValue with length =0 

compareBuf fer . length = 15 
compareOf f set = 15 
compareLength = 


Result of compareValue() is 





6.2.5.10.4 Test Coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


L 13 > 16 J 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 


C2 


11 



6.2.5.1 1 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference: API_2_ERH_FACYB_BS 
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6.2.5.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.5.11.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API_ 


_2_ 


_ERH 


_FACYB_ 


_BS_ 


_l.scr 


Test Applet: 


API. 


_2_ 


_ERH 


_FACYB_ 


_BS_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ERH 


_FACYB_ 


_BS_ 


_l.ldr 


Cleanup Script: 


API_ 


_2_ 


_ERH 


_FACYB_ 


_BS_ 


_l.clr 



6.2.5.11.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyValue() with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLV with TAG: 0D and length 16 
Select Text String TLV 








dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > dstBuffer.length 

dstBuffer.length = 15 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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dstOffset = 






6 


clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f indAndCopyValue () 
tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




7 


appendTLV with TAG: OD and value: 04 00 01 
... OF 








Successful call 

Tag = ODh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndCopyValue() is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuff er . length = 20 
dstOffset = 2 


Result of findAndCopyValue() is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 








append a 2 nd Text String TLV 









Successful call 

tag = ODh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndCopyValue() is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 









Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndCoDvValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

dstBuff er . length = 16 
dstOffset = 


Result of findAndCopyValue() is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 
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CRR number 


Test case number 


IN I 


O, I U. \ c. 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 




2, 3, 4, 5 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: API_2_ERH_FACYBBS_BSS 
6.2.5.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.5.12.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
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Test Script: API_2_ERH_FACYBBS_BSS_l.scr 

Test Applet: API_2_ERH_FACYBBS_BSS_l.java 

Load Script: API_2_ERH_FACYBBS_BSS_l.ldr 

Cleanup Script: API_2_ERH_FACYBBS_BSS_l.clr 



6.2.5.12.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyValue() with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLV with TAG: 0D and length 16 








dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer. length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: 0D and length 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 

U.O 1— J_i til iy U 1 1 — _L 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
ROIINDARIF^ iq thrown 

L_)\_/ vJ 1 N 1— / f\ 1 1 1 1 O lo LI 1 1 U Vv 1 1 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f indAndCopyValue () 
tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLength ( ) method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




12 


clear the handler and appendTLV with TAG: 
0D and value: 04 00 01 ... OF 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 17 


Result of findAndCopyValue() is 
17 
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dstOffset = 








dst Length = 17 






1 3 


Comoarp buffer 

hnf fpr = 04 DD 01 OF 1 


Rpqillt ic 00h 




1 A 

1 4 


initialise usiDuner 

dstBuffer = 55 55 ... 55 








Successful call 


Result of findAndCopyValue() is 






tag = ODh, occurrence = 1 


15 






valueOffset = 2 








dstBuffer . length = 20 








ctstUr rset — o 








dstLength = 12 






15 


Compare buffer 

buffer = 

55 3D 55 01 02 

03 04 05 06 07 
08 09 OA 0B 0C 

cc cc cc cc cc 
U «J ~J *J J J .J -J .J -J 


Result is OOh 




l b 


Appenu a lexioiring ilv 

tag = 0D 

Duffer = 00 11 z z Jj 4 4 55 (no specific 
DCS byte) 








ouccessTui can 


Result of findAndCopy Value() is 






tag = ODh, occurrence = 1 


17 






valueOffset = 








dstBuff er . length = 20 








dstOffset = 








dstLength = 17 






-j -7 


compare Duner 

buffer = 04 00 01 ... OF 


rtGSUU IS uun 




1 Q 
\ O 


ouccessTui can 

tag = ODh, occurrence = 2 
valueOffset = 
dstBuffer . length = 6 
dstOffset = 
dstLength = 6 


nesuii or nnuAnaL'Opy vaiue() is 
6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 






oIppk thp hanrllpi* anH annpnHTI V u/itki TAfi* 

\j 1 CCl 1 L 1 IC 1 lul IU 1 CI CI 1 1 LI CIUUCI IU 1 LV W 1 11 1 1 nvl ■ 

nn onH c\a no ni dp 

UU allu ValUC UH- UU U I ... ur 








Successful call (with tag 8Dh) 

tag = 8Dh 


Result of findAndCopyValue () is 
1 7 






occurrence = 1 








valueOffset = 








dstBuffer . length = 17 








dstOffset = 








dstLength = 17 






21 


Comoarf* buffer 

Vvl 1 1 MUl C *J Ul Ivl 

hiiffpr = 04 00 01 OF 


Rpqillt ic OOh 




oo 
<L<L 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 


Result of findAndCopyValue () is 
16 






occurrence = 1 








valueOffset = 








dstBuff er . length = 16 








dstOffset = 








dstLength = 16 






23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 




24 


Successful call, findAndCopyValue with 
length =0 

dstBuff er . length = 16 
dstOffset = 16 
dstLength = 


Result of findAndCopyValue () is 
16 
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CRR numhpr 

VI II 1 1 IUIIIUCI 


Tp^t rasp numhpr 

1 C3I UQOC IIUIIIUCI 


N1 


13 I"} 17 19 


MO 


\ \ 


N3 


12, 14, 16, 18, 24 


N4 


20, 21, 22, 23 


P1 


1 


[ P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.13 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ERH_FACRB_BS 
6.2.5.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRN1: if no TLV element is found, the UN A VAIL AB LE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.5.13.3 Test Suite files 

Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_FACRB_BS_l.scr 
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Test Applet: API_2_ERH_FACRB_BS_1 .java 

Load Script: API_2_ERH_FACRB_BS_l.ldr 
Cleanup Script: API_2_ERH_FACRB_BS_l.clr 



6.2.5.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 








findAndCompareValue() with a null dstBuffer and 
tag ODh 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareuTTsei + lengin > 
compareBuffer.length 

compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLV with TAG 02 
ana Length oz 








Select a TLV (tag 02h) 









f indAndCompareValue () 
tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




7 


Verify current TLV 

getValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




8 


clear the handler and appendTLV with TAG: 
0D and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 


Result is OOh 






compareOffset = 






9 


Verify current TLV 

getValueLength ( ) 


Result is 17 




10 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




11 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... Or 








Compare buffers with same parameters 


Result is +1 




12 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 








Compare buffers 


Result is OOh 






compareOffset = 2 






13 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 








02 03 04 05 06 








07 08 09 OA 0B 








0C 0D 0E OF 55 








Compare buffers 


Result is OOh 
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compareOf f set = 2 






14 


Initialise compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 








Compare buffers 

compareOffset = 2 


Rp^ult 19 -1 




1 <i 
I o 


Initialicp pninnarpRiiffpr 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0D 10 55 








Compare buffers 

compareOffset = 2 


Result is +1 




16 


clear the handler and appendTLV with TAG: 
0D and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 


Result is OOh 






tag = 8Dh 








compareBuf fer . length = 17 
compareOffset = 






17 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 


Result is OOh 






tag = 8Fh 








compareBuf fer . length = 16 








compareOffset = 







6.2.5.13.4 Test Coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


7,9 


N3 


8, 13, 12 


N4 


10, 14 


N5 


11,15 


N6 


17, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 
Envelope response 
handler 



6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: API_2_ERH_FACRBBS_BSS 
6.2.5.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 
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Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRN1: if no TLV element is found, the UN A VAIL AB LE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException B AD_INPUT_P AR AMETER. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AV AIL ABLE. 

6.2.5.14.3 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 



API_2_ERH_FACRBBS_BSS_1 .scr 



Test Applet: 



API_2_ERH_FACRBBS_BSS_1 .java 



Load Script: 



API_2_ERH_FACRBBS_BSS_1 .ldr 



Cleanup Script: 



API_2_ERH_FACRBBS_BSS_1 .clr 
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6.2.5.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareValue() with a null 
compareBuffer 


NullPointerException is thrown 




2 


clear the handler and appendTLV with TAG: 
0D and value: 04 00 01 ... OF 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




o 


>compareBuffer. length 

compareBuffer . length = 5 
compareOffset = 3 
compareLength = 3 


Ml lay ll lUcX^Ulwl DUUl lUbCXocJpilU 

n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler and appendTLV with TAG 
and length of 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_P 
ARAMETER is thrown 




12 


appendTLV with TAG 02 and length 02 








Select a TLV (tag 02h) 








f indAndCompareValue () 
tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




13 


Verify current TLV 

getValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




14 


clear the handler and appendTLV with TAG: 
0D and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValue() 

tag = ODh, occurrence = 1 


Result is OOh 
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valueOffset = 








compareOf f set = 
compareLength = 17 






15 


Verify current TLV 

getValueLength ( ) 


Result is 17 




16 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




I o 


IMIUdlloc OUI 1 1 |Jdl CDU 1 1 CI 

compareBuffer = 

c c etc: etc: ni m 
33 33 33 UI Uz 

03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Compare buffers 


Result is OOh 






valueOffset = 2 








compareOf f set = 3 








compareLength = 12 






19 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




20 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA 0D 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




21 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 









IMIUdlloc OUI 1 1 |Jdl CDU 1 1 CI 

compareBuffer = 
04 00 01 ... OF 








1 1 1 IUMI IU V/UI ll|Jcll C VdlUC^ 

tag = ODh, occurrence = 1 


Dqci ii+ ic nnh 

rlcbUIL lb UUil 






valueOffset = 








compareOf f set = 








compareLength = 17 






00 


Initial ico rnmnaroRi iffar 
II II lid Hoc; LUI 1 1 [Jcli c DU 1 1 c 1 

compareBuffer = 

00 11 22 33 44 55 








IIIIUnMUV/UI 1 1 |Jdl cvaiucy 


Dooi lit ic nnh 

rrcbUIL lb uuil 






tag = ODh, occurrence = 2 








valueOffset = 








compareOf f set = 








compareLength = 6 






01. 


Initiolico r^nmnaraRi iffar 
IMILIdlloC OUI 1 1 |Jdl CDU 1 1 CI 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValue() 

tag = ODh, occurrence = 2 


Result is -1 






valueOffset = 








compareOf f set = 








compareLength = 6 






24 


clear the handler and appendTLV with TAG: 
0D and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 


Result is OOh 






tag = 8Dh, occurrence = 1 








valueOffset = 








compareBuf fer . length = 17 
compareOf f set = 








compareLength = 17 
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25 


Append tag OFh 

buffer = 00 01 ... OF 








II midlist? OUI 1 1 |Jcll CDU 1 1 CI 








compareBuf f er = 00 01 ... OF 








Successful call (with tag 8Fh) 


Result is OOh 






tag = 8Fh, occurrence = 1 








valueOffset = 








compareBuf fer . length = 16 








compareOf f set = 








compareLength = 16 






26 


Successful call, findAndCompareValue with 
length =0 

CompareBuf fer . length = 16 
compareOf f set =16 
compareLength = 


Result of findAndCompareValue 
() is 00 





6.2.5.14.4 Test Coverage 



CRR number 


Test case number 


N1 


12,13 


N2 


15,13 


N3 


14, 18, 22, 21, 26 


[ N4 


16, 19, 23 


N5 


17, 19 


N6 


25, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.15 Method appendArray 

Test Area Reference: API_2_ERH_APDA_BSS 
6.2.5.15.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, short offset, short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: appends a buffer into the EditHandler buffer 
CRRN2: a successful append does not modify the TLV selected 

Parameters error 

CRRP1: if buffer is null, a java.lang. NullPointerException is thrown 

CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang. ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 
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CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
H ANDLER_NOT_ A V AIL AB LE 

6.2.5.15.2 Test suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_APDA_BSS_l.scr 
Test Applet: API_2_ERH_APDA_BSS_1 .java 

Load Script: API_2_ERH_APDA_BSS_l.ldr 
Cleanup Script: API_2_ERH_APDA_BSS_l.clr 



6.2.5.15.3 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Initialize the envelope response handler with ; 
TLV of length 1 



Null buffer 



NullPointerException is thrown 



offset > buffer.length 

buf fer . length = 5 
offset = 5 
length = 1 



ArraylndexOutOfBoundsExceptio 
n is thrown 



offset < 



buffer . length 
offset = -1 
length = 1 



ArraylndexOutOfBoundsExceptio 
n is thrown 



length > buffer.length 

buffer.length = 5 
offset = 
length = 6 



ArraylndexOutOfBoundsExceptio 
n is thrown 



offset + length > buffer.length 



buffer.length = 5 
offset = 3 
length = 3 



ArraylndexOutOfBoundsExceptio 
n is thrown 



buffer.length = 5 
offset = 
length = -1 



length < 



ArraylndexOutOfBoundsExceptio 
n is thrown 



Handler overflow 

buffer.length = 256 
offset = 

length = 256 



ToolkitException. HANDLER_OV 
ERFLOW is thrown 



append the handler with TLVs: 

31 03 11 22 33 

32 02 99 77 



findTLV 0x81 



buffer = FF FE 
offset = 
length = 8 



Successful call 

F8 



Verify Current TLV: Call getValueLengthQ 



Result is 03h 



Clear the handler 



Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 



Call copy() method 



Compare handler 

compareBuf f er = FF FE ... F8 



Result is OOh 



10 



Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 



Call copy() method 



Compare handler 

compareBuf fer = FF FE ... F8 02 03 ... 07 



Result is OOh 



11 



Successful call 
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buffer = 11 22 ... 88 
offset = 2 
length = 4 






Call copy() method 








Compare handler 

compareBuf fer = FF FE ... F8 02 03 ... 07 33 

44 55 66 


Result is OOh 





6.2.5.15.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


N3 




P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.16 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_ERH_ APTLB B 

6.2.5.16.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (1-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

No requirements 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_A VAIL ABLE 

6.2.5.16.2 Test suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_APTLBB_l.scr 
Test Applet: API_2_ERH_APTLBB_1 .java 

Load Script: API_2_ERH_APTLBB_l.ldr 
Cleanup Script: API_2_ERH_APTLBB_l.clr 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 121 ETSI TS 101 955 V8.0.0 (2002-09) 



6.2.5.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArray() 

length = 253 








Handler Overflow: Call twice the 
appendTLV()method 


ToolkitException.HANDLEROV 
ERFLOW is thrown by one of the 
two. 




2 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 









Select Command Details TLV 








Call the appendTLVT) method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 








tag = 84h 








value = OOh 








Call copy() method 








Compare handler 

compareBuf fer = 84 01 00 


Result is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copy() method 








Compare handler 


Result is OOh 






compareBuf fer = 84 01 00 01 01 FE 







Note : Test case 1 call twice appendTLV because the current 03.19 [7] is not clear enough on this point. So this test 
allows the two possible implementations. 

6.2.5.16.4 Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.1 7 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_ERH_APTLBBB 
6.2.5.17.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte valuel, byte value2) 
throws ToolkitException 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (2-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

No requirements 
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Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
H ANDLER_NOT_ A V AIL AB LE 

6.2.5.17.2 Test suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_APTLBBB_l.scr 
Test Applet: API_2_ERH_APTL BBB_1 Java 

Load Script: API_2_ERH_APTL BBB_1 .ldr 

Cleanup Script: API_2_ERH_APTLBBB_l.clr 

6.2.5.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArray with length of 253 








Handler Overflow: Call the appendTLV() 
method 


ToolkitException. HANDLER_OV 
ERFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVT) method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 








tag = 84h 
valuel = OOh 








value2 = Olh 








Call copy() method 








Compare handler 


Result is OOh 






compareBuf fer = 84 02 00 01 






4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copy() method 








Compare handler 

compareBuf fer = 84 02 00 01 01 02 FE FD 


Result is OOh 





6.2.5.17.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4 


N2 


2 


C1 


1 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.1 8 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) 

Test Area Reference: API_2_ERH_APTLB_BSS 
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6.2.5.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte[] value, 
short valueoffset, 
short valuelength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRP1: if value is null, a java. lang. NullPointerException is thrown 

CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
H ANDLER_NOT_ A V AIL AB LE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
B AD_INPUT_P AR AMETER 

6.2.5.18.2 Test suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


_2_ 


_ERH 


_APTLB_ 


_BSS_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


_ERH 


_APTLB_ 


_BSS_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ERH 


_APTLB_ 


_BSS_ 


_l.ldr 


Cleanup Script: 


API. 


_2_ 


_ERH 


_APTLB_ 


_BSS_ 


_l.clr 
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6.2.5.18.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value. length 

value. length = 5 
valueOffset = 5 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

value. length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value. length 

value . length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValueOffset + valueLength > value. length 

value . length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value . length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value. length = 254 

VdlUcUllbcL — U 

valueLength = 254 


ToolkitException.HANDLEROV 
ERFLOW is thrown 




8 


Bad parameter 

value. length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD INPUT P 
ARAMFTFR i<; thrown 




g 


rlpar thp handlpr annpnd thp handlpr with 

ul^ul 1 1 1 \-* | | d | | \A 1 1 ■ QmmvI 1 u 1 1 lu 1 IQI I vl Ivl V V III l 

TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 









Succp^ful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Call copy() method 









finmnarp handlpr 








CompareBuf f er = 04 08 FF FE ... F8 






11 


Successful call 

tag = 85h 
value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 









Call codvO method 

X-/ 1_4 1 1 Vr V w y V / II 1 v 11 1 wvl 








Comnarp handlpr 

\-/ V_7 III UQI v* 1 Id 1 1 VI 1 V* 1 


Rpcijlt jc on 






i- ninna roRnf far — DA £ W VP F 1 R fiS £ 09 








03 ... 07 






12 


Successful call 

V^ Vi w w v ww 1 VI 1 vw 1 1 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copy() method 








Compare handler 


Result is 00 






compareBuf fer = 04 08 FF FE ... F8 85 06 02 








03 ... 07 01 04 33 44 55 66 






13 


Clear the handler 








Successful call 








tag = 04 
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value = 00 01 ... 7F 
valueOffset = 
valueLength = 80h 






Call copy() method 








Compare handler 

compareBuf fer = 04 81 80 00 01...7F 


Result is 00 





6.2.5.18.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 


C3 


8 



6.2.5.1 9 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: API_2_ERH_APTLBB_BSS 
6.2.5.19.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte[] value2, 
short value2of f set, 
short value21ength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRP1: if value2 is null, a java.lang. NullPointerException is thrown 

CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang. ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_A VAIL ABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 
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6.2.5.19.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.19.3 



API_2_ERH_APTLBB_BSS_1 .scr 
API_2_ERH_APTLBB_BSS_1 Java 
API_2_ERH_APTLBB_BSS_1 .ldr 
API_2_ERH_APTLBB_BSS_1 xlr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2. length 

value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2. length 

value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2. length 

value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




8 


Bad parameter 

value2 . length = 256 
value20ffset = 

Vd.-LUfcrZJ_itrliyLll — Z 3D 


ToolkitException. BAD_INPUT_P 
ARAMETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 






Select Command Details TLV 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Call copy() method 








Compare handler 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result is 00 




11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 
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Call copy() method 








Compare handler 


Result is 00 






compareBuf f er = 








04 09 05 FF FE ... F8 








85 07 55 02 03 ... 07 






12 


Successful call 

tag = 01 

va 1 np1 = 4 4h 

T7-= 1 no? = 1 1 9 9 R R 

value20ffset = 2 

value2Length = 4 








Call copy() method 








Compare handler 

C omp 3r"sBuffsr" = 

04 OS VF VF VP, 

U ^ U y \J -J £ £ E Li ... £ (J 


Result is 00 






D7 ss 09 en 07 








01 05 44 33 44 55 66 






13 


Clear the handler 








Successful call 








tag = 04 








valuel = 00 








value2 = 01 ... 7F 








value20ffset = 








value2Length = 7Fh 








Call copy() method 








Compare handler 

compareBuf fer = 04 81 80 00 01...7F 


Result is 00 





6.2.5.19.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 


C3 


8 



6.2.5.20 Method clear 

Test Area Reference: API_2_ERH_CLER 
6.2.5.20.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void clear () 

throws ToolkitException 

Normal execution 

CRRN1: Clears the TLV list of an EditHandler and resets the current TLV selected. 

Parameters error 

No requirements 

Context errors 

CRRC1: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
H ANDLER_NOT_ A V AIL AB LE 
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6.2.5.20.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.20.3 



API_2_ERH_CLER_1 .scr 
API_2_ERH_CLER_1 Java 
API_2_ERH_CLER_1 .ldr 
API_2_ERH_CLER_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 
Call the getLength() method 


Result of getLength() is not null 






Clear the handler 

Call the getLength() method 


Result of getLength() is 




2 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 





6.2.5.20.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for 
EnvelopeResponseHandl 
er 



6.2.6 Class MEProfile 
6.2.6.1 Method check (byte index) 

Test Area Reference: API_2_MEP_CHECB 
6.2.6.1.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte index) 
throws ToolkitException 

Normal execution 

CRRN1: The method checks a facility in the handset profile: returns true if supported and false if not. 
Parameters error 

CRRP1: The method shall throw ME_PROFILE_NOT_AV AIL ABLE ToolkitException if Terminal Profile data are 
not available 

Context errors 

No requirements 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.6.1.3 



API_2_MEP_CHECB_1 .scr 
API_2_MEP_CHECB_1 Java 

API_2_MEP_CHECB_1 .ldr (the applet is loaded without INI after the reset (RST) 
API_2_MEP_CHECB_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by unformatted SMS 
Index = 1 


MEPROFILENOTAVAILABLE 
ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

index = 


true is returned by the method 




3 


Terminal Profile, Facility is not supported 

Index = 15 


false is returned by the method 





6.2.6.1.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


1 



6.2.6.2 Method check (byte [ ] mask, short offset, short length) 

Test Area Reference: API_2_MEP_CHEC_BSS 
6.2.6.2.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte [] mask, 

short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRN1: The method checks all the facilities corresponding to bits set to 1 in the mask buffer: returns true if they 
are all supported and false if not. 

CRRN2: The method returns true if the length to check is 0. 
Parameters error 

CRRP1: The method shall throw java. lang. NullPointerException if mask is null. 

CRRP2: The method shall throw java.lang. ArraylndexOutOfBoundsException if offset or length or both would 
cause access outside array bounds. 

CRRP3: The method shall throw ME_PROFILE_NOT_AV AIL ABLE ToolkitException if Terminal Profile data are 
not available. 
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Context errors 

No requirements 

6.2.6.2.2 Test suite files 

Specific triggering: 

UNFORMATTED_SMS_PP_UPD 
No Additional requirements for the GSM personalisation: 

Test Script: API_2_MEP_CHEC_BSS_l.scr 

Test Applet: API_2_MEP_CHEC_BSS_l.java 

Load Script: API_2_MEP_CHEC_BSS_1 .ldr (the applet is loaded without INI after the reset (RST)) 

Cleanup Script: API_2_MEP_CHEC_BSS_l.clr 
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6.2.6.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


■ 




No Terminal Profile is registered 


yc pRHFII F MOT AVAII 






Triggered by unformatted SMS 

Mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


ABLE ToolkitException is 
thrown 






Offset 


= 






Length 


= 16 






2 


NULL as parameter to check 

mask= NULL 


NullPointerException is 

thrown 

LI II U Wl 1 




Q 
O 


mask 


Offset > mask.length 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


A f rii il nrJ r\\st\i i4rif Dai m/^oCvA 

Array inoGxuuTUTDOunostxc 
eption is thrown 






: : ■ 


= 17 




A 

4 


mask = 


Offset < 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


Array IndexOutOfBoundsExc 
eption is thrown 






Offset 


= -1 




5 


mask = 


Length > mask.length 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


ArraylndexOutOfBoundsExc 
eption is thrown 






Offset 


= 






Length 


= 18 






D 


Mask = 


Offset + length > mask.length 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


Miidy IIIUuXwUl^lDUUllUbCXo 

eption is thrown 






Offset 


= 9 






Length 


= 9 






7 


mask = 
Offset 
Length 


length = 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
= 
= 


True is returned 




8 




Check all the Terminal Profile 


false is returned by the 






mask = 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


method because facility 15 is 






Offset 
Length 


= 
= 16 


not supported 




9 




Check a part of the Terminal Profile 


true is returned by the 






mask = 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


method: the 16 first facilities 






Offset 
Length 


= 15 
= 2 


except facility 15 have been 
successfully checked 




10 




Check a part of the Terminal Profile 


false is returned by the 






mask = 
Offset 
Length 


0x0080 
= 
= 2 


method only facility 15 is 
checked and not supported. 





6.2.6.2.4 Test Coverage 



CRR number 


Test case number 


N1 


8,9,10 


N2 


7 


P1 


2 


P2 


3,4,5,6 


P3 


1 



6.2.7 Class ProactiveHandler 
6.2.7.1 Method getTheHandler 

Test Area Reference: API_2_PAH_GTHD 
6.2.7.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveHandler getTheHandler ( ) 

throws ToolkitException 
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Normal execution 

CRRN1: The method shall return the single system instance of the ProactiveHandler class. 
CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

Parameter errors 

No requirements 

Context errors 

CRRC1: The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 



6.2.7.1.2 Test Suite files 



Test Script: 


API. 


2. 


_PAH_ 


_GTHD_ 


l.scr 


Test Applet: 


API. 


2. 


_PAH_ 


_GTHD_ 


.l.java 


Load Script: 


API_ 


_2_ 


_PAH_ 


_GTHD_ 


.l.ldr 


Cleanup Script: 


API. 


2. 


_PAH_ 


_GTHD_ 


l.clr 



6.2.7.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerO twice 


The returned objects shall be the 
same 




2 


getTheHandler() 


The reference shall be a 
ProactiveHandler 




3 


getTheHandler() 


The reference shall not be null 





6.2.7.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in 
Framework tests and 
insert here cross 
reference 


C1 


To be checked in 
Framework tests and 
insert here cross 
reference 



6.2.7.2 Method init 

Test Area Reference: API_2_PAH_INITBBB 
6.2.7.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void init (byte type, 

byte qualifier, 
byte dstDevice) 
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Normal execution 

CRRN1: The init() method initialises the next Proactive command in the ProactiveHandler, with Command details 
and Device Identities TLV. The source device is always the SIM Card (81h). The Comprehension Required flags 
are set. 

CRRN2: The Command number may take any value between Olh and FEh. 
CRRN3: The init() method clears the ProactiveHandler before initialising it. 
CRRN4: No TLV is selected after a call to the method. 
CRRN5: The handler is not sent to the mobile by the init() method. 

Parameter errors 

No requirements 

Context errors 

No requirements 



6.2.7.2.2 Test Suite files 



Test Script: 


API. 


_2_ 


PAH 


_INITBBB_ 


_l.scr 


Test Applet: 


API. 


2. 


PAH 


_INITBBB_ 


_l.java 


Load Script: 


API. 


_2_ 


.PAH 


_INITBBB_ 


.l.ldr 


Cleanup Script: 


API_ 


2. 


_PAH 


_INITBBB_ 


.l.clr 



6.2.7.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the init() method 

type = Olh 
qualifier = 02h 
dstDevice = 03h 

Copy ProactiveHandler in a byte array 
(source) 
Compare the byte array 

reference = 

81h 03h xxh Olh 02h 

82h 02h 81h 03h 


source and reference are 
identical 




2 


Verify the command number value 


01h-FEh 




3 


Call the init() method 

type = FFh 
qualifier = FEh 
destination = FDh 

Copy ProactiveHandler in a byte array 
(source) 
Compare the byte array 

reference = 

81h 03h xxh FFh FEh 

82h 02h 81h FDh 


source and reference are 
identical 




4 


Select the 1st TLV in the handler 
Call the init() method with any value 








Call the getValueLengthQ method 


UNAVAILABLEELEMENT 
ToolkitException is thrown by 
getValueLengthQ 
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CRR number 


Test case number 


N1 


1,3 


N2 


2 


N3 


3 


N4 


4 j 


N5 


1,3 



6.2.7.3 Method initDisplayText 

Test Area Reference: API_2_PAH_INDTBB_BSS 
6.2.7.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initDisplayText (byte qualifier, 

byte dcs, 
byte[] buffer, 
short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRPvNl: The method shall build a DISPLAY TEXT proactive command in the ProactiveHandler, using qualifier, 
dcs and buffer parameters. Comprehension required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The DISPLAY TEXT command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRP1: The method shall throw NullPointerException if buffer is null. 

CRRP2: If offset or length or both would cause access outside array bounds, an ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRC1: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is too small to put 
the requested data. 



6.2.7.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_INDTBB_BSS_1 .scr 
API_2_PAH_INDTBB_BSS_1 .java 
API_2_PAH_INDTBB_BSS_1 .ldr 
API 2 PAH INDTBB BSS l.clr 
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6.2.7.3.3 Test procedure 



Id 




API Fynprtatinn 


APDII Exnprtatinn 

rtr L/U LA^JCUICJ IIUI 1 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

buffer = "Text" 
offset = 5 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
onset — o 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 


9 


Succesfull call, buffer is part of a buffer with 
the end part 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset — z 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 


10 


Succesfull call, buffer is part of a buffer with 
the first part 
Send the command 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

lext — lextt 


11 


Succesfull call, buffer is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

buffer — ±zlextDj>4 
offset = 2 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 


12 


Succesfull call, qualifier = 81 h 
Send the command 

qualifier = 81h 

s = 4 
buffer = "TextE" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

iTi i^i~l"i"F"ifZi"v" — Q 1 Vi 
L[Uall J Lei — OXil 

dcs = 4 

Text = "TextE" 


13 


Succesfull call, DCS=0 (7 bits) 
Send the command 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 
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length = 5 






14 


Succesfull call, DCS=8 (UCS2) 
Send the command 

qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 


15 


Call the initDisplayText() method with any 
value 

Then build and send a DISPLAY TEXT 
command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 
offset = 
length = 10 




DISPLAY TEXT Proactive 

nnmmanH 

LU 1 II 1 ICM IU 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 

buffer = "" (not null buffer) 
offset = 
length = 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the initDisplayText() method 
Call the getValueLength() method 


UNAVAILABLEELEMENT 
ToolkitException is thrown by 
getValuel_ength() 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length — /h.h 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




DISPLAY TEXT Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
1 enrit h = 9 4 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the initDisplayText() method with a too 
long buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the initDisplayText() without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 
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v^nn iiuiiiucri 


Tact raco numhor 


N1 


8 9 10 11 12 13 14 




15,16,18,19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.4 Method initGetlnkey 

Test Area Reference: API_2_PAH_INGKBB_BSS 
6.2.7.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGet Inkey (byte qualifier, 

byte dcs, 
byte[] buffer, 
short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRNl: The method shall build a GET INKEY proactive command in the ProactiveHandler, using qualifier, dcs 
and buffer parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INKEY command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRP1: The method shall throw NullPointerException if buffer is null. 

CRRP1: If offset or length or both would cause access outside array bounds, a ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRC1: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to put 
the requested data. 



6.2.7.4.2 Test Suite files 



Test Script: 


API_ 


.2. 


.PAH. 


.INGKBB. 


_BSS_ 


.l.scr 


Test Applet: 


API_ 


_2_ 


PAH. 


.INGKBB. 


_BSS_ 


.l.java 


Load Script: 


API_ 


_2_ 


PAH. 


.INGKBB. 


_BSS_ 


.l.ldr 


Cleanup Script: 


API_ 


_2_ 


_PAH_ 


.INGKBB. 


_BSS_ 


.l.clr 
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6.2.7.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




o 

d. 


offset > buffer.length 

buffer = "Text" 
offset = 5 


Array IndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
onset — o 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 


9 


Succesfull call, buffer is part of a buffer with 
the end part 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 


10 


Succesfull call, buffer is part of a buffer with 
the first part 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextC" 


11 


Succesfull call, buffer is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

buffer — !2lextLM4 
offset = 2 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 


12 


Succesfull call, qualifier = 81 h 

qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = 81h 
dcs = 4 

Text = "TextE" 


13 


Succesfull call, DCS=0 (7 bits) 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 


14 


Succesfull call, DCS=8 (UCS2) 

qualifier = 




GET INKEY Proactive 
command 
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dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 


15 


Call the initGetlnkey() method with any value 
Then build and send a GET INKEY command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 
offset = 

1 enrrth = 10 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 




GET INKEY Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the initGetlnkey() method 
Call the getValueLength() method 


UNAVAILABLEELEMENT 
ToolkitException is thrown by 
getValuel_ength() 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




GET INKEY Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




GET INKEY Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
1 enrit h = 9 4 

Icily Ull — 




GET INKEY Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the initGetlnkey() method with a too long 
buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the initGetlnkey() without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 



6.2.7.4.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 9, 10, 11, 12, 13, 14, 




15, 16, 18, 19, 20 


N2 


15 


N3 


17 j 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 
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6.2.7.5 Method initGetlnput 

Test Area Reference: API_2_PAH_INGPBB_BSSSS 
6.2.7.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnput (byte qualifier, 

byte dcs, 
byte[] buffer, 
short offset, 
short length, 
short minRespLength, 
short maxRespLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: The method shall build a GET INPUT proactive command in the ProactiveHandler, using qualifier, dcs, 
buffer, minRespLength and maxRespLength parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INPUT command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRP1: The method shall throw NullPointerException if buffer is null. 

CRRP2: If offset or length or both would cause access outside array bounds, a ArraylndexOutOfBoundsException 
shall be thrown. 



Context errors 

CRRC1: A ToolkitException.HANDLER_OVERFLOW 
the requested data. 



6.2.7.5.2 Test Suite files 



Test Script: 


API_ 


.2. 


PAH 


JNGPBB. 


J3SSSS. 


Test Applet: 


API. 


_2_ 


.PAH 


JNGPBB. 


BSSSS. 


Load Script: 


API_ 


_2_ 


_PAH 


JNGPBB. 


JSSSSS. 


Cleanup Script: 


API_ 


_2_ 


_PAH 


JNGPBB. 


_BSSSS. 



shall be thrown if the ProactiveHandler is to small to put 

J.scr 
J. java 
J.ldr 
J.clr 
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6.2.7.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2. 


offset > buffer.length 

buffer = "Text" 
offset = 5 


Array IndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
offset = 3 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 


No exception is thrown 




\/ar!fn Ilia r*r\vmnr\'^v\tA mimhai' uqIiia 

veriTy iric coiiiiTicina nuniDer vaius 


Command number between 01 h 
and -FEh 




8 


Send the command 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 
Min Length = OOh 
Max Length = FFh 


9 


Succesfull call, buffer is part of a buffer with 
the end part 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 
minRespLength = lOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 
Min Length = lOh 
Max Length = FFh 


10 


Succesfull call, buffer is part of a buffer with 
the first part 
Send the command 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 
minRespLength = FFh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextC" 
Min Length = FFh 
Max Length = FFh 


11 


Succesfull call, buffer is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextD34" 
offset = 2 
length = 5 
minRespLength = OOh 
maxRespLength = OOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 
Min Length = OOh 
Max Length = OOh 


12 


Succesfull call, qualifier = 81 h 

qualifier = 81h 
dcs = 4 




GET INPUT Proactive 
command 
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buffer = "TextE" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = lOh 




qualifier = 81h 
dcs = 4 

Text = "TextE" 
Min Length = OOh 
Max Length = lOh 


13 


Succesfull call, DCS=0 (7 bits) 

ejus. 1 i f i e it = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 
minRespLength = lOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 
Min Length = lOh 
Max Length = lOh 


14 


Succesfull call, DCS=8 (UCS2) 

gusli fier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 
Min Length = OOh 
Max Length = FFh 


15 


Call the initGetlnput() method with any value 
Then build and send a GET INPUT command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 
offset = 
length = 10 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 
Min Length = OOh 
Max Length = lOh 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 

Min Length = OOh 

Max Length = lOh 


17 


Select a TLV in the ProactiveHandler 
Call the initGetlnput() method 
Call the getValueLength() method 


UNAVAILABLEELEMENT 
ToolkitException is thrown by 
getValueLength() 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 
Min Length = OOh 
Max Length = lOh 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 
Min Length = OOh 
Max Length = lOh 


20 


Successful call, buffer length = 236 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 236 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

Tp Y f Cfr-inn TTV — 
-L fc;.?>. L. OL.l--L.Liy 1 Li v — 

8D 81 ED 04 55 55... 


21 


Call the initGetlnput() method with a too long 
buffer 


HANDLER_OVERFLOW 
ToolkitException is thrown 
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qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 237 
minRespLength = OOh 
maxRespLength = lOh 






22 


Call the initGetlnput() without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 



6.2.7.5.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 9, 10, 11, 12, 13, 14, 




15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.6 Method send 

Test Area Reference: API_2_PAH_SEND 

6.2.7.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte send() 

Normal execution 

CRRNl: The send() method send the current proactive command to the mobile. 

CRRN2: The returned byte is equal to general result of the command (first byte of Result TLV in Terminal 
Response). 

CRRN3: The handler remains unchanged after a call to send() method until the use of initXX() or appendTLV(). 

CRRN4: There is no invocation of select() or deselect() method. 

CRRN5: A pending toolkit applet transaction at the method invocation is aborted. 

Parameter errors 

No requirements 

Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown is the Result Simple TLV is missing in 
Terminal Response. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is missing 
in the Result Simple TLV in Terminal Response. 

6.2.7.6.2 Test Suite files 

Test Script: API_2_PAH_SEND_l.scr 
Test Applet: API_2_PAH_SEND_l.java 
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Load Script: API_2_PAH_SEND_l.ldr 
Cleanup Script: API_2_PAH_SEND_l.clr 



6.2.7.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 

UUb — U 411 

buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


2 


Terminal Response with General Result = 00 

r\fcroLL-LL ± J_i V — \J J> U _L UU ^ L- LMLLlLLcli 1U j~J C -L J_ U -L 1 LLC LI 

successfully) 


Result of send() is OOh 




3 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


4 


Terminal Response with General Result = 01, 
without Additional information on result 

Dponlt TT.V = "3 01 01 ( r nmm^i n H nprf nrmpH 

r\C O U-L L 111 v — \J *J W_L w_L ^L'LHLLlLLClll Li kJC-L -LLJ-LILLC Li 

with partial comprehension) 


Result of send() is 01 h 




5 


Build and send a DISPLAY TEXT command 

qualifier = OOh 

ULb — U 411 

buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


6 


Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 

nor f ^rTn^H i^r "i Vi :a >" ~i 3 1 rTimnrQriQPQi 

■Jfcr _L 1_ LJ -L ILLfcr Li W1L11 jycl-Ll Lcl-L L- LMLL'J JltilltillO-LLJIl ) 


Result of send() is 01 h 




7 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


8 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 


Result of sendQ is 02h 




9 


Build and send a 7Fh byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 73h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 7F 

Text String TLV = 8D 74 

04 55 55 55... 


10 


Build and send a 80h byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 74h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 8 
Text String TLV = 8D 75 
04 55 55 55... 


11 


Build and send a maximum length command 
(length of the handler should be 253) 

DISPLAY TEXT: 
Qualifier = 
dc s = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 FD 
Text String TLV = 8D 81 
tti n/i r s r s 


12 


Verify that the Proactive Handler is not 
modified after a send() 
Build a DISPLAY TEXT command 

Copy ProactiveHandler to source byte array 

Send command 

Copy ProactiveHandler to destination byte 
array 
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Compare source and destination 


Source and destination are 
identical 




13 


Build and send a DISPLAY TEXT command 
Verify there is no invocation of select() or 
deselect() method. 




DISPLAY TEXT Proactive 
command 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 3D 


Result of send() is 02h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple 
TLV 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown by send() 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without general result 
byte in the Simple TLV 

Result TLV = 03 00 


ToolkitException. OUT OF TLV_ 
BOUNDARIES is thrown by 
sendQ 





6.2.7.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 10, 11, 12, 




13, 14 


N2 


2, 4, 6, 8, 14 


N3 


12 


N4 


13 


N5 


To be checked in 




Framework tests and 




insert here cross 




reference 


C1 


15 


C2 


16 



6.2.7.7 Method getLength 

Test Area Reference API_2_PAH_GLEN 

6.2.7.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRN1: returns the length in bytes of the TLV list. 

Parameter errors 

No requirements 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 
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6.2.7.7.2 Test Suite files 



Test Script: 


API_ 


_2_ 


_PAH_ 


_GLEN_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


_PAH_ 


_GLEN_ 


_l.java 


Load Script: 


API_ 


_2_ 


_PAH_ 


_GLEN_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_PAH_ 


_GLEN_ 


.l.clr 



6.2.7.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLength() is 




2 


Call the init() method 

getLength ( ) 


Result of getLength() is 9 




3 


Call the initDisplayText() method, with buffer 
length = 240 

getLength ( ) 


Result of getLength() is 253 




4 


Build a 7Fh Proactive Handler 

getLength ( ) 


Result of getLength() is 7Fh 




5 


Build a 80h Proactive Handler 

getLength ( ) 


Result of getLength() is 80h 





6.2.7.7.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4,5 


C1 


Does not apply for 
Proactive Handler 



6.2.7.8 Method copy 

Test Area Reference API_2_PAH_COPY_BSS 
6.2.7.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 
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CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 



6.2.7.8.2 Test Suite files 



Test Script: 


API_ 


2. 


_PAH_ 


COPY_ 


BSS_ 


l.scr 


Test Applet: 


API_ 


_2_ 


_PAH_ 


_ COPY 


_BSS. 


_l.java 


Load Script: 


API_ 


_2_ 


_PAH_ 


_ COPY. 


_BSS. 


_l.ldr 


Cleanup Script: 


API_ 


_2_ 


_PAH_ 


_ COPY. 


_BSS. 


_l.clr 



6.2.7.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the init() method 






DstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


DstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copy() is 9 




9 


Compare the buffer 


Result of arrayCompare() is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copy() is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copy() is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 
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CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 




ProactiveHandler 



6.2.7.9 Method findTLV 

Test Area Reference API_2_PAH_FINDBB 

6.2.7.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRN1: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRP1: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException B AD_INPUT_P AR AMETER . 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.7.9.2 Test Suite files 

Test Script: API_2_PAH_FINDBB_l.scr 

Test Applet: API_2_PAH_FINDBB_l.java 

Load Script: API_2_PAH_FINDBB_l.ldr 

Cleanup Script: API_2_PAH_FINDBB_l.clr 
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6.2.7.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








Invalid input parameter 

Occurrence = 


ToolkitException . BADJ NPUTP 
ARAMETER is thrown 




2 


Call the init() method 








Search 1st TLV 

Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLength() method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLength() method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLVNOTFOUND 




7 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 


Result is TLV NOT FOUND 




9 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search thp TLV 

Tag = 02h 
Occurrence = 2 


Rpci 1 If i c 

TLV_FOUND_CR_NOT_SET 




1 1 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 





6.2.7.9.4 Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


Does not apply for 




Proactive Handler 



6.2.7.10 Method getValueLength 

Test Area Reference API_2_PAH_GVLE 
6.2.7.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 
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Normal execution 

CRRN1: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.10.2 Test Suite files 



Test Script: 


API. 


_2_ 


PAH 


_GVLE_ 


_Lscr 


Test Applet: 


API. 


_2_ 


PAH 


_GVLE_ 


_l.java 


Load Script: 


API. 


2. 


PAH 


_GVLE_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


PAH 


_GVLE_ 


.l.clr 



6.2.7.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the init() method 








getValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Call the appendTLV() method 

tag = 0D 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 






getValueLength ( ) 


Result is OOh 




3 


Call the initDisplayText() method 

length = 1 (+ dcs byte) 








Search TLV ODh (Text String TLV) 






getValueLength ( ) 


Result is 02h 




4 


Call the initDisplayText() method 
length = 7Eh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Call the initDisplayText() method 

length = 7Fh (+ dcs byte) 








Search TLV ODh (Text String TLV) 






getValueLength ( ) 


Result is 80h 




6 


Call the initDisplayText() method 

length = FOh (maximum text length) 








Search TLV ODh (Text String TLV) 






getValueLength ( ) 


Result is F1h 
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6.2.7.10.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for 
Proactive Handler 


C2 


1 



6.2.7.1 1 Method getValueByte 

Test Area Reference API_2_PAH_GVBYS 

6.2.7.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte ( short valueOffset) 
throws ToolkitException 

Normal execution 

CRRN1: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRP1: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES . 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.7.11.2 Test Suite files 



Test Script: 


API. 


_2_ 


_PAH_ 


_GVBYS_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


_PAH_ 


_GVBYS_ 


_l.java 


Load Script: 


API_ 


2. 


_PAH_ 


_GVBYS_ 


_l.ldr 


Cleanup Script: 


API. 


_2_ 


_PAH_ 


_GVBYS_ 


.l.clr 
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6.2.7.11.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the init() method 

type = FFh 
qualifier = FEh 
destination = FDh 









get vaiueuyte(U) 


1 OOlKltbXCeptlOn. UNAVAILABLE 

ELEMENT is thrown 




d. 


searcn ilv uin (i/Ommana uetans ilv^ 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




c. 




II II LLyiO|JICiy 1 CAly 

buffer = 00 01 ... 7D 
length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


initDisplayText() 

buffer = 00 01 ... 7D 7E 
length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




7 


getValueByte(7F) 


Result is 7Eh 




8 


initDisplayText() 

buffer = 00 01 ... EF 
length = FOh 

Search TLV ODh (Text String TLV) 








getValueByte(FO) 


Result is EFh 





6.2.7.11.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 




Proactive Handler 


C2 


1 



6.2.7.12 Method copyValue 

Test Area Reference API_2_PAH_CPYVS_BSS 
6.2.7.12.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 
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Normal execution 

CRRN1: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.12.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.12.3 



Test Suite files 

API_2_PAH_CPYVS_BSS_1 .scr 
API_2_PAH_CPYVS_BSS_1 .java 
API_2_PAH_CPYVS_BSS_1 .ldr 
API_2_PAH_CPYVS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 
Select a TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


initDisplayText() with length = 15 

Select Text String TLV 








dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer. length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayText() with length = 5 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 
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dstBuff er . length = 15 
















dstLength = 






8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
dstBuff er . length = 15 

dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

dstLength > Text String length 
valueOffset = 
dstBuff er . length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




\ U 


[oeieci lexioiring ilvj 

v alUcyi 1 L i d o I L 11 - k) 1 ±11U 

length 

valueOffset = 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


1 OOlKITbXCGptlOn.UU 1 _Ur_ 1 LV_ 

RPil IMHARIPQ ic thrruA/n 
DkJUNDMriiCo IS THrOWN 




11 


Initialise the handler 








copyValue() 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






'■ — 7 Zn~- i T 77T 

initDisplay I ext() 

dcs = 4 

buffer = 00 01 ... OF 
Select Text String TLV 








Surrp^f ul call 








valueOffset = 








dstBuff er . length = 17 








dstOffset = 








dstLength = 17 






13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of copyValue() is 15 






valueOffset = 2 








dstBuff er . length = 20 








H o +- n-F -F o — ^ 
UbtUIIbSt — J 








dstLength = 12 






15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 


Result is OOh 





6.2.7.12.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


[ P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Handler 


C2 


11 



6.2.7.13 Method com pare Value 

Test Area Reference API_2_PAH_CPRVS_BSS 
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6.2.7.13.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 



public byte compareValue ( short valueOffset, 



byte[] compareBuf f er , 
short compareOf f set, 
short compareLength) 



throws java . lang . NullPointerException, 



java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 



Normal execution 

Compares the last found TLV element with a buffer: 
CRRN1: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.13.2 



Test Suite files 



Test Script: 



API_2_PAH_CPRVS_BSS_1 .so- 



Test Applet: 



API_2_PAH_CPRVS_BSS_1 .java 



Load Script: 



API_2_PAH_CPRVS_BSS_1 .ldr 



Cleanup Script: 



API_2_PAH_CPRVS_BSS_1 .clr 
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6.2.7.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 
Select a TLV 








compareValue() with a null compareBuffer 


NullPointerException is thrown 




d. 


miTuispiay i exi(j wnn lengtn = id 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 

L- UlLip cx _L fcr J_i til iy U 1 1 — _L 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayText() with length = 5 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV_ 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 

L- (JlLip Cl _L trJ_i til ly I— 1 1 — / 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT_OF_TLV_ 

RDI INriARIF^ k thrown 

O W U INUnniLO lo UIIUvVII 




11 


Initialise the handler 








compareValue() 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


initDisplayText() 

dcs = 4 

hnffciT- — 00 (11 OV 

Select Text String TLV 














Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

valueOffset = 
compareOffset = 
compareLength = 17 


Result is OOh 




13 


Initialise compareBuffer 
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compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Comnarp buffpr^ with samp naramptpr^ 

\_/ v> 1 I 1 C4 I \-* KJ\A 1 1 v 1 O Will 1 OCI 1 1 1 ulll VI III v Iv 1 O 


Rpci lit |Q -t-1 




15 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 OS 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 









Compare buffers 

valueOffset = 2 
compareOf f set = 3 

p" r~\m t~i ^ y~ T , n rr +~ In = 19 

1 L L kJ Cl-Lv^-l-lv^llvjUll — 1 i 


Result is OOh 




1 6 


Initiali^p romnarpRiiffpr 

II 1 1 L 1 CI 1 IO w v^/l 1 1 MU 1 v f W 1 1 v 1 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Comnarp buffprs with samp naramptprs 

\_/ v> 1 I I y~* *-* 1 v VU 1 1 v 1 O Will 1 OCI 1 1 1 w UQI CI III 1 O 


Rpqi lit iq -1 

1 ICOU 1 L 1 o 1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA 0D 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





6.2.7.13.4 Test Coverage 



CRR number 


Test case number 


N1 


12,15 j 


N2 


13, 16 


N3 


14, 17, 18 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Handler 


C2 


11 



6.2.7.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference API_2_PAH_FACYB_BS 
6.2.7.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 
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byte[] dstBuffer, 
short dstOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 



6.2.7.14.2 Test Suite files 



Test Script: 


API. 


_2_ 


.PAH 


_FACYB_ 


_BS_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


_PAH 


_FACYB_ 


_BS_ 


l.java 


Load Script: 


API_ 


_2_ 


_PAH 


_FACYB_ 


_BS_ 


l.ldr 


Cleanup Script: 


API_ 


_2_ 


_PAH 


_FACYB_ 


_BS_ 


l.clr 



6.2.7.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








FindAndCopyValue() with a null dstBuffer 


NullPointerException is thrown 




2 


lnitDisplayText() with length = 15 








dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

DstBuffer.length = 20 
DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


initDisplayText() 








Select a TLV (tag 02h) 








findAndCopyValue() 

tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 
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7 


initDisplayText() 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

Tag = ODh 

DstBuffer . length = 17 
DstOffset = 


Result of findAndcopyValue() is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer . length = 20 
dstOffset = ? 


Result of findAndcopyValue() is 
19 




10 


Compare buffer 

buffer = 

SS SS 4 01 

U U J W 4 WW W_L 

02 03 04 05 06 
07 08 09 OA 0B 
0C 0D OE OF 55 


Result is OOh 




1 1 


initDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 








append a 2nd Text String TLV 








Successful call 

tag = ODh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndcopyValue() is 

1 7 
I / 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


initDisplayText() 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndcopyValue() is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

dstBuff er . length = 16 
dstOffset = 


Result of findAndcopyValue() is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.7.14.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




Proactive Handler 
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6.2.7.15 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PAH_FACYBBS_BSS 

6.2.7.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AV AIL ABLE. 

6.2.7.15.2 Test Suite files 



Test Script: 


API_ 


_2_ 


.PAH 


_FACYBBS_ 


_BSS_ 


l.scr 


Test Applet: 


API. 


_2_ 


PAH 


_FACYBBS_ 


_BSS_ 


l.java 


Load Script: 


API_ 


_2_ 


.PAH 


_FACYBBS_ 


_BSS_ 


l.ldr 


Cleanup Script: 


API_ 


_2_ 


.PAH 


FACYBBS. 


_BSS_ 


l.clr 
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6.2.7.15.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyValue() with a null dstBuffer 


NullPointerException is thrown 




2 


initDisplayText() with length = 15 








dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer. length 

dstBuffer.length = 5 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




c; 
\j 


H^tOffcpt 4- ri^tLpnnth ^H^tRuffpr Ipnnth 

ujiuiijcl t ujilci u i ^uo iuu 1 1 ci . ivi ly 11 1 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


/Al 1 ay 1 1 lUCAWULWI UUU IUCl_ALCpilU 

n is thrown 




6 


dstLength < 

dstBuffer.length = 5 

H Q+- O-F -F qo+- — 
UbLUllbeL — U 

dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayText() with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffsjr.lsricfth = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 

I— J \w/ Vw^ 1 N 1 — J 1 VI 1 1 l__ \_J \ O LI II \J V V 1 1 




11 


lnitDisplayText() 








Select a TLV (tag 02h) 








findAndCopyValue() 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
lllmln i is tnrown. 




12 


initDisplayText() 

dcs = 4 

hn^FciT- — oo ni ov 

IJUl lei — UU U± ... Ur 









Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValue() is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 
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dstBuffer = 55 55 ... 55 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 2 
dstBuffer . length = 20 
dstOffset = 3 
dstLength = 12 


Result of findAndcopyValue() is 
15 




15 


Compare buffer 

buffer = 

fii no 
55 55 55 Ul uz 

03 04 05 06 07 

08 09 OA 0B 0C 

55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

tag = 0D 

Duller — UU 11 zz jj 44 33 (no speciric 
DCS byte) 









Successful call 

uay — \j u i l f <j l- ui j_ j_ c; i il. c; — _l 

valueOffset = 
dstBuffer . length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValue() is 

I / 




17 


Compare buffer 

hnf fpr = 04 DO 01 CiV 


Result is OOh 




18 


Successful call 

|- ari = nnVi nrrnrr^nrp = 

L-Ciy — \J U 1 1 f L^L^L^Ul-L-LvrllL'V^ — ^ 

valueOffset = 
dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


Result of findAndCopyValue() is 

c 
D 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


initDisplayText() 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuff er . length = 17 
dstOffset = 
dstLength = 17 


Result of findAndcopyValue() is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuff er . length = 16 
dstOffset = 
dstLength = 16 


Result of findAndcopyValue() is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 
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PRR nurnhpr 
vnn i iui i iuci 


1 Col lidOC IIUIIIUCI 


IN I 


r 1Q IK 17 1Q 

I O, I J, \l, I 3 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20, 21, 22, 23 


P1 


1 


[ P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




ProactiveHandler 



6.2.7.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference API_2_PAH_FACRB_BS 

6.2.7.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AV AIL ABLE. 

6.2.7.16.2 Test Suite files 

Test Script: API_2_PAH_FACRB_BS_l.scr 
Test Applet: API_2_PAH_FACRB_BS_1 .java 
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Load Script: API_2_PAH_FACRB_BS_l.ldr 
Cleanup Script: API_2_PAH_FACRB_BS_l.clr 



6.2.7.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareValue() with a null dstBuffer 


NullPointerException is thrown 




2 


initDisplayText() with length = 15 








tag = ODh 

compareBuf fer . length = 20 
compareOf f set = 21 


AiravlnrlPYfli itOfRni mrlQFYPPntin 

tW \ ay II lUCAWU LWI UUUI IUO 1— AUC|J LI U 

n thrnwn 

II 1 O 11 II U VV 1 1 




3 


compareOffset < 

compareBuf fer . length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer. length 

compareBuf fer . length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 

compareBuffer . length 
compareBuf fer . length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


lnitDisplayText() 








Select a TLV (tag 02h) 









findAndCompareValueQ 

tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 







Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown. 




7 


initDisplayText() 

dcs = 4 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 17 




9 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 









Compare buffers with same parameters 


Result is -1 




10 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 








Compare buffers 

compareOffset = 2 


Result is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 
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Compare buffers 

kj 1 L L kJ CllCvl 1 OCL — ^ 


Result is OOh 




13 


Initialise compareBuffer 

nnmna roRn f f pr = 

1 L L kJ alCDUl J-Cl — 

55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 








Compare buffers 

rnmria rpflf f cpt" = 

K-^ {J 1 L L kJ CllCvl 1 OCL — ^ 


Result is -1 




14 


Initialise compareBuffer 

rnnrna roRn f f pr = 

{J 1 L L kJ al CDU L 1C1 — 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0D 10 55 









Compare buffers 

compareOf f set = 2 


Result is +1 




15 


initDisplayText() 

dcs = 4 

buffer = 00 01 ... OF 









Initialise compareBuffer 

CompareBuffer = 04 00 01 ... OF 









Successful call (with tag 8Dh) 

tag = 8Dh 

compareBuf fer . length = 17 
compareOf f set = 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is OOh 




17 


Initialise compareBuffer 

compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is +1 





6.2.7.16.4 Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




Proactive Handler 



6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PAH_FACRBBS_BSS 
6.2.7.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 
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public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRN1: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException B AD_INPUT_P AR AMETER. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 



6.2.7.17.2 Test Suite files 



Test Script: 


API_ 


_2_ 


PAH 


_FACRBBS_ 


_BSS_ 


_lscr 


Test Applet: 


API_ 


_2_ 


PAH. 


_FACRBBS_ 


_BSS_ 


l.java 


Load Script: 


API_ 


_2_ 


PAH 


_FACRBBS_ 


_BSS_ 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH 


_FACRBBS_ 


_BSS_ 


l.clr 
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6.2.7.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareValue() with a null 
compareBuffer 


NullPointerException is thrown 




2 


initDisplayText() with length = 15 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 

^compareBuffer . length 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayText() with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




1 


valupOff^pt + romoarpLpnath ^» Tpxt Strina 

v mucw i j i — l t w 1 1 1 kj n i i — i_ i — 1 1 y 1 1 1 . — i i — /\ i on ■ ■ iu 

length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


TnnlkitFxrpntinn Ol IT OF Tl V 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_P 
ARAMETER is thrown 




12 


lnitDisplayText() 








Select a TLV (tag 02h) 









findAndCompareValue() 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
pi fmfmt ic thrnwn 

1 l_ 1 1 VI 1 1 N 1 lo UIIUVVll 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




13 


initDisplayText() 

dcs = 4 

buffer = 00 01 ... OF 














Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 


Result is OOh 
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tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 






14 


Verify current TLV 

getValueLength ( ) 


Result is 17 




15 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Comnarp buffprs with samp naramptprs 


Rpci lit iq -t-1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 

f~ 1 f"lTTl"T~i;3"K~£iT,£ir"irT"r"l~l = 1 / 
Kj 1 L L kJ al CLiCIIm — 1 ^ 


Result is OOh 




1 8 


Initialise romnarpRiiffpr 

II 1 1 \ 1 VI 1 IO w uwl 1 1 Iv VI 1 v ■— ' VI 1 1 v 1 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Comnarp huffprs with samp naramptprs 

\h/ \J 1 1 1 V/VI 1 v V/ VI 1 1 v 1 v Will 1 Ovl 1 1 Iv mvII VI III v Iv 1 w 


Rpci lit |Q -1 

1 ICOU 1 L ID 1 




1 9 


Initialise romnarpRuffpr 

1 1 1 1 VI VI 1 1 w v v V/l 1 1 1* VI 1 v f VI 1 1 W 1 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA 0D 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

rnnTna roRn f f pr = 

1 L L kJ CI J- CD U L 1 CI — 

04 00 01 ... OF 









findAndCompareValue() 

Lay — \JUIL/ <J L. L. UI -L -L Cr 1 1L- C; — _L 

valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialise compareBuffer 

r"'f~sTTiT^;3T~£^Ri~i"f""f"£i"r~~ = 
1 L L kJ Ql CDU L 1C1 — 

00 11 22 33 44 55 








findAndCompareValue() 

L- a. y — \J U l L f kJL-'L-'UL.L.LCrllL-'C — ^ 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValue() 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 


Result is -1 
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compareLength = 6 






23 


initDisplayText() 

dcs = 4 

buffer = 00 01 ... OF 








iniiiaiis& comparcDUTTer 

CompareBuf fer = 04 00 01 ... OF 









oUucessTUi can ^wiin lag o^rij 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuf fer . length = 17 
compareOf f set = 
compareLength = 17 


riesuii is uun 




24 


Append tag OFh 

buffer = 00 01 ... OF 








imuaiis& comparcDUTTer 

compareBuf fer = 00 01 ... OF 








ouccessTUi can ^wiin lag ornj 

tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuf fer . length = 16 
compareOf f set = 
compareLength = 16 


riesuii is uun 




25 


Initialise compareBuffer 

compareBuf fer =0099 02 ... OF 








findAndCompareValue() 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 





6.2.7.17.4 Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17, 20, 21 


N4 


15, 18, 22 


N5 


16, 19 


N6 


23, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




Proactive Handler 



6.2.7.18 Method appendArray 



Test Area Reference: API_2_PAH_APDA 
6.2.7.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, 
short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 
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Normal execution 

CRRN1: appends a buffer into the Edithandler buffer 
CRRN2: a successful append does not modify the TLV selected 

Parameters error 

CRRP1: if buffer is null, a java.lang.NullPointerException is thrown 

CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_A VAIL ABLE 



6.2.7.18.2 Test suite files 



Test Script: 


API. 


_2_ 


PAH 


_APDA_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


PAH 


_APDA_ 


_l.java 


Load Script: 


API_ 


_2_ 


.PAH 


_APDA_ 


Lldr 


Cleanup Script: 


API. 


_2_ 


.PAH 


_APDA_ 


.l.clr 



6.2.7.18.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

buf fer . length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

buffer.length = 256 
offset = 
length = 256 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




8 


Initialise handler 








Select Command Details TLV 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




9 


Clear the handler 








Successful call 
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buffer = FF FE ... F8 
offset = 
length = 8 









Call copy() method 








Compare the arrays 

compareBuf f er = FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copy() method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




11 


Successful call 

buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copy() method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 33 

44 55 66 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




12 


Clear the handler 








Successful call 

buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLength() method 


result = 253 






Call copy() method 








Compare handler 

compareBuf fer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCo 
mpareQ is OOh 





6.2.7.18.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




ProactiveHandler 



6.2.7.19 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_PAH_APTLBB 
6.2.7.19.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (1-byte element). 
CRRN2: A successful append does not modify the TLV selected. 
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Parameters error 

No requirements 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_A VAIL ABLE 



6.2.7.19.2 Test suite files 



Test Script: 


API_ 


_2_ 


.PAH 


_APTLBB_ 


_l.scr 


Test Applet: 


API. 


_2_ 


PAH 


_APTLBB_ 


_l.java 


Load Script: 


API_ 


_2_ 


PAH 


_APTLBB_ 


.l.ldr 


Cleanup Script: 


API_ 


_2_ 


.PAH 


_APTLBB_ 


.l.clr 



6.2.7.19.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArray() 

length = 251 






Handler Overflow: Call the appendTLV() 
method 


ToolkitException. HANDLER_OV 
ERFLOW is thrown 




2 


Initialise handler 








Select Command Details TLV 








Call the appendTLVT) method 






Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 






Successful call 

tag = 84h 
value = OOh 








Call copy() method 








Compare the arrays 

compareBuf fer = 84 01 00 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copy() method 








Compare the arrays 

compareBuf fer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




5 


Clear the handler 








Call appendArray() 

length = 250 

buffer = 00 81 F7 03 04 ... F9 








Successful call 

tag = 84h 
value = OOh 








Call getLength() method 


result = 253 1 






Call copy() method 








Compare the array 

compareBuf fer = 00 81 F7 03 04 ... F9 84 01 

00 


Result of 

javacard.framework.Util.arrayCo 
mpareQ is OOh 
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CRR number 


Test case number 


N1 


3, 4, 5 


N2 


2 


C1 


1 


C2 


Does not apply for 




Proactive Handler 



6.2.7.20 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_P AH_ APTLB B B 

6.2.7.20.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte value) 
throws ToolkitException 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (2-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

No requirements 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
H ANDLER_NOT_ A V AIL AB LE 

6.2.7.20.2 Test suite files 



Test Script: 


API. 


_2_ 


PAH 


_APTLBBB_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


PAH. 


_APTLBBB_ 


_l.java 


Load Script: 


APT 


_2_ 


.PAH 


_APTLBBB_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_PAH 


_APTLBBB_ 


.l.clr 
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6.2.7.20.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initDisplayText() 

length = 250 








Handler Overflow: Call the appendTLVQ 
method 


1 OOlKltbXCeptlOn.MANULbriUV 

ERFLOW is thrown 




2 


Initialise handler 








Select Command Details TLV 








Call the appendTLVT) method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call copy() method 









Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copy() method 








Compare the arrays 

compareBuf fer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




5 


Clear the handler 








Call appendArray() 

length = 249 

buffer = 00 81 F6 03 04 ... F8 









Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLength() method 


result = 253 






Call copy() method 








Compare handler 

compareBuf fer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCo 
mpareQ is OOh 





6.2.7.20.4 Test Coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for 




Proactive Handler 



6.2.7.21 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) 

Test Area Reference: API_2_PAH_APTLB_BSS 
6.2.7.21.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



175 



ETSI TS 101 955 V8.0.0 (2002-09) 



byte[] value, 
short valueof f set, 
short valuelength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRP1: if value is null, a java. lang. NullPointerException is thrown 

CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_A VAIL ABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 



6.2.7.21.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.21.3 



Test suite files 

API_2_PAH_APTLB_BSS_l.scr 
API_2_PAH_APTLB_BSS_l.java 
API_2_PAH_APTLB_BSS_1 .ldr 
API_2_PAH_APTLB_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value . length = 5 
valueOffset = 6 
valueLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

value . length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value . length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueOffset = 


ToolkitException. HANDLER_OV 
ERFLOW is thrown 
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valueLength = 254 






8 


Bad parameter 


ToolkitException.BAD_INPUT_P 






value. length = 256 


ARAMETER is thrown 






valueOffset = 








valueLength = 256 






9 


Initialise handler 








Select Command Details TLV 








Successful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Verify Current TLV: Call getvaiueLengtn ( > 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Call copy() method 








Compare the arrays 


Result of 






compareBuf fer = 04 08 FF FE ... F8 


javacard.framework.Util.arrayCo 








mpare() is OOh 




11 


Successful call 








tag = 85h 








value = 00 01 ... 07 








valueOffset = 2 








valueLength = 6 








Call copy() method 








Compare the arrays 


Result of 






compareBuf fer = 04 08 FF FE ... F8 85 06 02 


javacard.framework.Util.arrayCo 






03 ... 07 


mpare() is OOh 




12 


Successful call 








tag = 01 








value = 11 22 ... 88 








valueOffset = 2 








valueLength = 4 








Call copy() method 








Compare the arrays 


Result of 






compareBuf fer = 04 08 FF FE ... F8 85 06 02 


javacard.framework.Util.arrayCo 






03 ... 07 01 04 33 44 55 66 


mpareO is OOh 




13 


Clear the handler 








Successful call 








tag = 04 








value = 00 01 ... 7F 








valueOffset = 








valueLength = 80h 









Call copy() method 








Compare the arrays 


Result of 






compareBuf fer = 04 81 80 00 01...7F 


javacard.framework.Util.arrayCo 








mpare() is OOh 




14 


Clear the handler 








Successful call 








tag = 04 








value = 00 01 ... F9 








valueOffset = 








valueLength = 250 








Call getLength() method 


result = 253 






Call copy() method 








Compare handler 


Result of 






compareBuf fer = 04 81 FA 00 01...F9 


javacard.framework.Util.arrayCo 








mpareQ is OOh 
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CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




Proactive Handler 


C3 


8 



6.2.7.22 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: API_2_PAH_APTLBB_BSS 
6.2.7.22.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte [ ] value2 , 
short value2of f set , 
short value21ength) 
throws java . lang . Nu 1 IP o inter Except ion, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRP1: if value2 is null, a java.lang.NullPointerException is thrown 

CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
H ANDLER_NOT_ A V AIL AB LE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 



6.2.7.22.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test suite files 

API_2_PAH_APTLBB_BSS_1 .scr 
API_2_PAH_APTLBB_BSS_1 .java 
API_2_PAH_APTLBB_BSS_1 .ldr 
API_2_PAH_APTLBB_BSS_1 xlr 
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6.2.7.22.3 Test procedure 



Id 


DescriDtion 


API ExDectation 


APDU ExDectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2. length 

value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

value2 . length = 5 
valuezOffset = -1 
value2 Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2. length 

value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2. length 

value2 . length = 5 
value20ffset = 3 
value2 Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

value2 . length = 5 
value20ffset = 
value2Length = — 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


ToolkitExrpntion HANDLER OV 
ERFLOW is thrown 




Q 
o 


RaH nnrnmptpr 
ucju yjai ai i ic lci 

TT-a 1 no9 1 Qnrrt- h — 9 S f, 
Vcl-LLlfcrZ, . -Lfcrliyull — 

ValUC^vllOCL W 

value2Length = 256 


TnnlkitFyrpntinn RAD IMPI IT P 

AriAivit i tn is tnrown 




9 


Initialise handler 








Select Command Details TLV 








Successful call 








tag = 04 








valUcl — UJ 








i,a 1 llo 9 — T7F 17 Q 

Va± Litri — r r r n ... r o 








value20ffset = 








value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 
valuel = 05 








value2 = FF FE ... F8 








value20ffset = 








value2Length = 8 








Call copy() method 








Compare the arrays 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copy() method 








Compare the arrays 

compareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




12 


Successful call 

tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copy() method 








Compare the arrays 

CompareBuf fer = 

04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareQ is OOh 
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85 07 55 02 03 ... 07 
01 05 4 4 33 44 55 do 






13 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copy() method 








Compare the arrays 

compareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




1 A 


dpar thp hanrilpr 








^ufrp^^f ill rail 

tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLength() method 


result = 253 






Call copy() method 








Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


Result of 

javacard.framework.Util.arrayCo 
mpareQ is OOh 





6.2.7.22.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




Proactive Handler 


C3 


8 



6.2.7.23 Method clear 

Test Area Reference: API_2_PAH_CLER 



6.2.7.23.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void clear () 

throws ToolkitException EditHandler 

Normal execution 

CRRN1: Clears the TLV list of an EditHandler 
CRRN2: Resets the current TLV selected. 



Parameters error 

No requirements 
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Context errors 

CRRC1: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_A VAIL ABLE 



6.2.7.23.2 Test suite files 



Test Script: 


API. 


_2_ 


.PAH 


_CLER_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


_PAH 


_CLER_ 


_l.java 


Load Script: 


API_ 


_2_ 


_PAH 


_CLER_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_PAH 


_CLER_ 


.l.clr 



6.2.7.23.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 

Select Command Details TLV 
Call the getLength() method 


Result of getLength() is not null 






Clear the handler 

Call the getLength() method 


Result of getLength() is 




2 


Call the getValueLengthQ method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 





6.2.7.23.4 Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


C1 


Does not apply for 
Proactive Handler 



6.2.8 Class ProactiveResponseHandler 
6.2.8.1 Method copyAdditionallnformation 



Test Area Reference: API_2_PRH_CPAI_BSS 
6.2.8.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyAdditionallnformation (byte [ ] dstBuffer, 

short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitException 

Normal execution 

CRRN1: The copyAdditionalInformation() method shall copy a part of the additional information field from Result 
TLV element in dstBuffer, using dstOffset and dstLength. 

CRRN2: dstBuffer shall only be modified from dstOffset to (dstOffset + dstLength - 1) (included). 

CRRN3: The method returns (dstOffset + dstLength). 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



181 



ETSI TS 101 955 V8.0.0 (2002-09) 



CRRN4: If a Result TLV element is available, it becomes the TLV selected after a call to the method. 
CRRN5: The method shall copy from the first Result TLV. 

Parameter errors 

CRRP1: A NullPointerException shall be thrown if dstBuffer is null. 

CRRP2: An ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstLength or both would cause 
access outside array bounds. 

Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if dstLength is greater than the value 
field of the available TLV. 



6.2.8.1.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.1.3 



Test Suite files 

API_2_PRH_CPAI_BSS_1 .scr 
API_2_PRH_CPAI_BSS _l.java 
API_2_PRH_CPAI_BSS _l.ldr 
API_2_PRH_CPAI_BSS _l.clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = 
dcs = 4 

buffer = "Text" 




DISPLAY TEXT Proactive 
command 




Terminal Response with 11 additional bytes 








Result TLV = 03 0C 01 01 23 45 67 89 AB 
CD EF 01 23 45 








NULL as parameter to dstBuffer 

dstBuffer = NULL 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer . length = 10 
dstOffset = 11 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 10 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 
dstLength = 11 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 6 
dstLength = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 10 
dstOffset = 6 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 








Result TLV = 03 06 01 01 23 45 67 89 
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Successfull call, dstBuffer is the whole buffer 


result of 






dstBuff er . length = 5 
dstOffset = 


copyAdditionallnformation() is 
05h. 






dstLength = 5 




8 


Compare dstBuffer using arrayCompare() 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompare() is OOh. 




9 


Call the getValueLength() method 


Result is 06h. 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 6 additional bytes 








Result TLV = 03 07 01 AB CD EF FE DC BA 









Successfull call, dstBuffer is part of a buffer 


result of 






dstBuff er . length = 7 
dstOffset = 2 
dstLength = 5 


copyAdditionallnformation() is 
07h. 




11 


Compare dstBuffer using arrayCompare() 

src = {AB, CD, EF, FE, DC} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompare() is OOh. 




12 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Rocnnnco with 7 firlrlitinnal hi/toc 
itriiiiiiicii nto|Juiioe wiiii i duuiuuiidi uyico 








Result TLV = 03 08 01 FE DC BA 98 76 54 

32 








Successfull call, dstBuffer is part of a buffer 


result of 






dstBuff er . length = 7 
dstOffset = 
dstLength = 5 


copyAdditionallnformation() is 
05h. 




13 


Compare dstBuffer using arrayCompare() 

src = {FE, DC, BA, 98, 76} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompare() is OOh. 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Torminnl Rocnnnco with ft arlrlitinnal h\/te»c 
iciiiiiiidi ncauui ioc wiiii o duuiuuiidi uyico 








Result TLV = 03 09 01 00 11 22 33 44 55 
66 77 








Successfull call, dstBuffer is the whole buffer 


result of 






dstBuff er . length = 9 
dstOffset = 2 
dstLength = 5 


copyAdditionallnformation() is 
07h. 




15 


Compare dstBuffer using arrayCompare() 

src = {00, 11, 22, 33, 44} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompare() is OOh. 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional bytes 








Result TLV = 03 81 F3 01 00 01 02 03... 








Successfull call to the method 


result of 






dstBuff er . length = F2h 
dstOffset = 
dstLength = F2h 


copyAdditionallnformation() is 
F2h. 




17 


Compare dstBuffer using arrayCompareQ 


result of arrayCompareQ is OOh. 





ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



183 



ETSI TS 101 955 V8.0.0 (2002-09) 





src = {00, 01, 02, 03, 04...} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = F2h 






18 


Call the getValuel_ength() method 


Result is F3h. 




19 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Tprminal Rp^non^p with 5 additional hvtp<5 








Result TLV = 03 06 01 00 11 22 33 44 








dstLength > data available 

dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


IT /""\ I — Tl \ / n /""\ 1 IN 1 I - \ A n 1 I — 1"* 

OUTOFTLVBOUNDARIES 
ToolkitException is thrown 




20 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 








Result TLV = 03 06 01 00 11 22 33 44 








Initialise dstBuffer 

dstBuffer = {00h, Olh, 02h, 03h...} 








Call the copyAdditionallnformation() method 

dstBuff er . length = 20 
dstOffset = 5 
dstLength = 5 








Compare dstBuffer using arrayCompare() 

src = { 


result of arrayCompare() is OOh 






OOh, Olh, 02h, 03h, 04h, 
OOh, llh, 22h, 33h, 44h, 
OAh ORh Orh ODh OFh 

W rtl 1 , uDll f W ' — 11, U U 11 / U Lill f 

OFh, lOh, llh, 12h, 13h} 
srcOffset = 
dest = dstBuffer 
destOffset = 
length = 20 






21 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 
elements 








1st Result TLV = 03 06 01 01 23 45 67 89 
2nd Result TLV = 03 01 00 








Successfull call to 
copyAdditionallnformation() 

dstBuff er . length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformation() is 
05h. 




22 


Compare dstBuffer using arrayCompare() 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompare() is OOh. 




23 


Call the getValueLength() method 


Result is 06h. 




24 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple 
TLV 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown by send() 






ProactiveResponseHandler, getTheHandler 
call copyAdditionallnformation() 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 
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CRR numhpr 

VI II 1 1 IUIIIUCI 


1 C3I UQOC IIUIIIUCI 


N1 


8, 11, 13, 15, 17, 20, 22 


N2 


20 


N3 


7, 10, 12, 14, 16, 21 


N4 


9, 18, 23 


N5 


21, 22, 23 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


24 


C2 


19 



6.2.8.2 Method copyTextString 

Test Area Reference: API_2_PRH_CPTS_BS 
6.2.8.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyTextString (byte [ ] dstBuffer, 

short dstOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRNl: The copyTextStringO method copies the text string value from the first Text String TLV element, using 
dstBuffer and dstOffset. 

CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

CRRN3: The method returns (dstOffset + length of copied value). 

Parameter errors 

CRRP1: A NullPointerException shall be thrown if dstBuffer is null. 

CRRP2: A ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstOffset + (length of the TextString 
to be copied, without the Data Coding Scheme included), as specified for the returned value, would cause access 
outside array bounds. 

Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 



6.2.8.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PRH_CPTS_BS_1 .scr 
API_2_PRH_CPTS_BS_1 .java 
API_2_PRH_CPTS_BS_1 .ldr 
API_2_PRH_CPTS_BS_1 .clr 
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6.2.8.2.3 Test procedure 



lu 




Mr 1 CXpcCldllOn 


A DRI 1 P vnaptof inn 

Mruu cxpeoidLiori 


1 


Build and send a GET INPUT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 




Terminal Response 








Text String TLV = 0D 02 04 41 








ProactiveResponseHandler.getTheHandler() ; 

call the copyTextStringQ method with a null 
dstBuffer 


NullPointerException is thrown 






dstBuffer = null 
dstOffset = 






2 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response 








Text String TLV = 0D 04 04 "ABC" 









dstOffset + text length > dstBuffer. length 

dstBuff er . length = 04h 
dstOffset = 02h 


ArraylndexOutOfBoundsException 
is thrown 




o 


uSlVjTTSei < u 

dstBuff er . length = 04h 
dstOffset = -1 


ArraylndexOutOfBoundsException 
is thrown 




4 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT 
Proactive command 




Terminal Response without Text String TLV 








ProactiveResponseHandler.getTheHandler() ; 

call the copyTextString ( ) method 


UNAVAILABLEELEMENT 
ToolkitException is thrown 




c 

o 


Pi i i |H and conrl a fiFT IMDI IT ^nmmanH 
duiiu diiu ociiu d vj c i inru 1 ouiimidf iu 




riFT IMPI IT PrnaptiuD 

command 
Proactive 




Terminal Response with a null Text String tlv 








Text String TLV = 0D 00 









Initialise dstBuffer 

dstBuffer = {F00h, FOlh, F02h, F03h} 








Call the copyTextString() method 


Result of copyTextString() is 02h 






dstBuffer . length = 04h 
dstOffset = 02h 






c 

D 


rnmnaro HctRl iffAr ncinn arrauPnmnaroM 
ouinpdic uaiDuiici uoiiiy di i dy wui i i|/di 

src = {0F0h, OFlh, 0F2h, 0F3h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


riubUIL Ul alid.y'*_/Ulll(Jd.lt;^; lb UUll 




■7 

/ 


DUIIU dnu ScMU a Ut 1 IIMrU 1 COITIiTldriu 




bt i iiNru i rroacuve 

command 

Proactive 




Terminal Response with text length = 01 h 








Text String TLV = 0D 02 04 41 








Initialise dstBuffer 

dstBuffer = {00h, Olh, 02h, 03h} 








Call the copyTextString() method 


Result of copyTextString() is 01 h 






dstBuff er . length = 04h 
dstOffset = OOh 
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8 


Compare dstBuffer using arrayCompare() 

src = (41h, Olh, 02h, 03h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompare() is OOh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 





Terminal Response with text length = 02h 








Text String TLV = OD 03 04 42 43 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextString() method 


Result of copyTextString() is 04h 






dstBuff er . length = 04h 
dstOffset — Uzh 






10 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompare() is OOh 




11 


Call the getValueLength() method 


Result is 03h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh 








Text String TLV = OD 7F 04 01 02 ... 7E 








Initialise dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 









Call the copyTextString() method 


Result of copyTextString() is 7Eh 






dstBuff er . length = 7Eh 
dstOffset = OOh 






13 


Compare dstBuffer using arrayCompare() 

src = {Olh, 7Eh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 7Eh 


Result of arrayCompare() is OOh 




14 


Call the getValueLength() method 


Result is 7Fh 




15 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh 








Text String TLV = OD 81 80 04 01 02 ...7F 








Initialise dstBuffer 

dstBuffer = {OOh, Olh ... FFh} 









Call the copyTextString() method 


Result of copyTextString() is 8Fh 






dstBuff er . length = FFh 
dstOffset = lOh 






16 


Compare dstBuffer using arrayCompare() 

Qrr = (OOh Olh OFh 

Olh, ...7Fh, 8Fh, ... FFh} 

srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompare() is OOh 




17 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh 








Text String TLV = OD 81 FO 04 01 02 ... EF 








Initialise dstBuffer 
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dstBuffer = {00h, OOh ... OOh} 








Call the copyTextString() method 


Result of copyTextString() is EFh 






dstBuff er . length = FFh 
Qsuuiisct — uun 






18 


Compare dstBuffer using arrayCompare() 

src = {Olh, ...EFh, OOh ... OOh } 

srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompare() is OOh 




19 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with two Text String TLV 








1st Text String TLV = OD 03 04 42 43 
2nd Text String TLV = OD 02 04 44 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextString() method 


Result of copyTextString() is 04h 






dstBuffer . length = 04h 
dstOr r set — Uzn 






20 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompare() is OOh 




21 


Call the getValueLengthQ method 


Result is 03h 





6.2.8.2.4 Test Coverage 



CRR number 


Test case number 


N1 


6, 8, 10, 13, 16, 18, 20 


N2 


11,14, 21 


N3 


5, 7, 9, 12, 15, 17, 19 


P1 


1 


P2 


2,3 


C1 


4 



6.2.8.3 Method getAdditionallnformationLength 

Test Area Reference: API_2_PRH_GTIL 

6.2.8.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getAdditionallnf ormationLength ( ) 
throws ToolkitException 

Normal execution 

CRRN1: This method returns the length of the additional information field from the first Result TLV in the 
ProactiveResponseHandler. 

CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

Parameter errors 

No requirements 
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Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 



6.2.8.3.2 Test Suite files 



Test Script: 


API. 


_2_ 


_PRH 


_GTIL_ 


T.scr 


Test Applet: 


API_ 


_2_ 


PRH 


_GTIL_ 


_l.java 


Load Script: 


API_ 


_2_ 


_PRH 


_GTIL_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


.PRH 


_GTIL_ 


.l.clr 



6.2.8.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information 








ProactiveResponseHandler.getTheHandler() ; 
call the getAdditionallnformationLength() 
method 


Result is OOh 




2 


Call the getValueLength() method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 1 additional byte 








Result TLV = 03 02 02 55 









ProactiveResponseHandler.getTheHandler() ; 
call the getAdditionallnformationLengthQ 
method 


Result is 01 h 




4 


Call the getValueLength() method 


Result is 02h 




c. 


Ruilrl unci cpnri a DI^PI AY TFYT rnmmanri 

DUIIU C1IIU jCIIU CI Ulur 1— r \ I 1 1 /\ 1 1#V/IIIIIIC1IIU 




DI^PI AY TFYT 

UIOT T I LA I 

ProactiveProactive 
command 




Terminal Response with 7Eh additional bytes 








Result TLV = 03 7F 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandler() ; 
call the getAdditionallnformationLength() 
method 


Result is 7Eh 




6 


Call the getValueLength() method 


Result is 7Fh 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 7Fh additional bytes 








Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandler() ; 
call the getAdditionallnformationLength() 
method 


Result is 7Fh 




8 


Call the getValueLength() method 


Result is 80h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 80h additional bytes 








Result TLV = 03 81 81 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 


Result is 80h 
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call the getAdditionallnformationLength() 
method 






10 


Call the getValuel_ength() method 


Result is 81 h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 





Terminal Response with F2h additional bytes 








Result TLV = 03 81 F3 02 55 55 55 ... 








rroaciiveriesponsenanaier.gei i nenanaiery , 
call the getAdditionallnformationLength() 
method 


rieSUIt IS r^n 




12 


Call the getValueLength() method 


Result is F3h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 2 Result TLV 








1st Result TLV = 03 03 02 01 23 
2nd Result TLV = 03 01 00 








r roaciivenesponsenanaier.gei i nerianaier(j , 
call the getAdditionallnformationLength() 
method 


nGSUIT IS U^n 




\ 4 


oan ine geivaiueLenginy meinoo 


riesuit is Uon 




\ 


duiiu anu scnu a uiorLAi i la i command 




niCDI AV TCYT 
Ulor LAY 1 tA 1 

Proactive command 




Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLEE 

i_l^ivil^in i lo Liiiuvvii uy bci luy 






Get ProactiveResponseHandler 








Call the getAdditionallnformationLength() 
method 


ToolkitException.UNAVAILABLEE 
LEMENT is thrown by 
getAdditionallnformationLength () 





6.2.8.3.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 3, 5, 7, 9, 11, 13 


N2 


2, 4, 6, 8, 10, 12, 14 


C1 


15 



6.2.8.4 Method getGeneralResult 

Test Area Reference: API_2_PRH_GTGR 
6.2.8.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getGeneralResult ( ) 

throws ToolkitException 

Normal execution 

CRRN 1 : This method returns the general result of a proactive command. 

CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

Parameter errors 

No requirements 
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Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is missing 
in the Result Simple TLV. 



6.2.8.4.2 Test Suite files 



Test Script: 


API_ 


.2. 


_PRH_ 


_GTGR_ 


_Lscr 


Test Applet: 


API. 


.2. 


_PRH_ 


_GTGR_ 


_l.java 


Load Script: 


API. 


.2. 


_PRH_ 


_GTGR_ 


Lldr 


Cleanup Script: 


API. 


.2. 


_PRH_ 


_GTGR_ 


.l.clr 



6.2.8.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


Terminal Response with General Result = 00 
(command performed successfully) 






ProactiveResponseHandler.getTheHandler() 
Call the getGeneralResult() method 


Result of getGeneralResult() is OOh 




2 


Call the getValueLength() method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 





Terminal Response with General Result = 01, 
without Additional information on result 
(command performed with partial 
comprehension) 








ProactiveResponseHandler.getTheHandler() 
Call the getGeneralResult() method 


Result of getGeneralResult() is 01 h 




4 


Call the getValueLength() method 


Result is 01 h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 








ProactiveResponseHandler.getTheHandler() 

Call the getGeneralResultQ method 


Result of getGeneralResult() is 01 h 




6 


Call the getValueLength() method 


Result is 02h 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 








ProactiveResponseHandler.getTheHandler() 

Call the getGeneralResultQ method 


Result of getGeneralResult() is 02h 




8 


Call the getValueLength() method 


Result is 04h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
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command 





Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandler() ; 
call the getGeneralResult() method 


Result is 02h 




10 


Call the getValueLength() method 


Result is 80h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 








ProactiveResponseHandler.getTheHandler() ; 

call the getGeneralResult ( ) method 


Result is 02h 




12 


Call the getValueLength() method 


Result is 02h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


Terminal Response without Result Simple 
TLV 


ToolkitException. UNAVAILABLEE 
LEMENT is thrown by send() 




ProactiveResponseHandler.getTheHandler() ; 
call the getGeneralResult() method 


UNAVAILABLEELEMENT 
ToolkitException is thrown 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


Terminal Response without General Result 
Byte in Result Simple TLV 


ToolkitException.UNAVAILABLEE 
LEMENT is thrown by send() 




ProactiveResponseHandler.getTheHandler() ; 

call the getGeneralResult ( ) method 
Result TLV = 03 00 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 3, 5, 7, 9, 11 


N2 


2, 4, 6, 8, 10, 12 


C1 


13 


C2 


14 



6.2.8.5 Method getltemldentifier 

Test Area Reference: API_2_PRH_GTII 

6.2.8.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

Normal execution 

CRRN 1 : The method returns the item identifier byte value from the first Item Identifier TLV element. 
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CRRN2: If an Item Identifier TLV element is available, it becomes the TLV selected. 

Parameter errors 

No requirements 

Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Item Identifier 
TLV element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the item identifier byte is missing 
in the Item Identifier Simple TLV. 



6.2.8.5.2 Test Suite files 



Test Script: 


API_ 


2. 


_PRH_ 


_GTII_ 


_Lscr 


Test Applet: 


API_ 


_2_ 


_PRH_ 


_GTII_ 


_l.java 


Load Script: 


API_ 


2. 


_PRH_ 


_GTII_ 


.Lldr 


Cleanup Script: 


APT. 


_2_ 


_PRH_ 


_GTII_ 


l.clr 



6.2.8.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Riiilrl anrl eonH o RIQDI A V TCYT rnmmonrl 
DUIIu dllU ScllQ a UlorLMi 1 LA 1 OUlMITldriU 




UlorLMY I t A I rlOaCUVe 

command 




1 CI IIIII Idl ricoLJUIlofc: ILtMIl lUc 1 1 LI 1 Icl 1 LV 

available) 






Call to getltemldentifier() with unavailable 
Item Identifier TLV 


UNAVAILABLEELEMENT 
ToolkitException is thrown 




2 


Build and send a SELECT ITEM command 
with 2 items (ID=01, 02) 




SELECT ITEM Proactive 
command 


Terminal Response with Item 1 selected 

Item Identifier TLV = 10 01 01 






Call the getltemldentifier() method 


Result is 01 h 




3 


Call the getValueByte() method 

valueOffset = OOh 


Result is 01 h 




4 


Build and send a SELECT ITEM command 
with 3 items (ID=03, 05, 07) 




SELECT ITEM Proactive 
command 


Terminal Response with Item 5 selected 

Item Identifier TLV = 10 01 05 








Call the getltemldentifier() method 


Result is 05h 




5 


Call the getValueByte() method 

valueOffset = OOh 


Result is 05h 




6 


Build and send a SELECT ITEM command 
with 3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 


Terminal Response with Item FFh selected 

Item Identifier TLV = 10 01 FF 








Call the getltemldentifier() method 


Result is FFh 




7 


Call the getValueByte() method 

valueOffset = OOh 


Result is FFh 




8 


Build and send a SELECT ITEM command 
with 3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 
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Terminal Response with 2 Item Identifier tlv 








1st Item Identifier TLV = 10 01 FFh 
2nd Item Identifier TLV = 10 01 FEh 








Call the getltemldentifier() method 


Result is FFh 




9 


Call the getValueByte() method 

valueOffset = OOh 


Result is FFh 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without item identifier in 
the Item Identifier Simple TLV 








Item Identifier TLV = 10 00 








Call to getltemldentifierQ 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.5.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 4, 6, 8 


N2 


3, 5, 7, 9 


C1 


1 


C2 


10 



6.2.8.6 Method getTextStringCodingScheme 

Test Area Reference: API_2_PRH_GTCS 

6.2.8.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTextStringCodingScheme ( ) 

throws ToolkitException 

Normal execution 

CRRN1: This method returns the data coding scheme from the first Text String TLV element. 
CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

Parameter errors 

No requirements 

Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the Text String TLV is present 
with a length of 0. 



6.2.8.6.2 Test Suite files 



Test Script: 


API. 


_2_ 


_PRH 


_GTCS_ 


_l.scr 


Test Applet: 


API, 


_2_ 


PRH 


_GTCS_ 


_l.java 


Load Script: 


API. 


_2_ 


_PRH 


_GTCS_ 


_l.ldr 


Cleanup Script: 


API. 


_2_ 


.PRH 


_GTCS_ 


.l.clr 
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6.2.8.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


Terminal Response (no Text String TLV 
element available) 






Call to getTextStringCodingScheme() with 
unavailable Text String TLV 


UNAVAILABLEELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = 0D 00 






Call the getTextStringCodingScheme() 
method 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




3 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 01 h, dcs 

= 04h 

Text String TLV = 0D 02 04 "A" 






Call the getTextStringCodingSchemeO method 


Result is 04h 




4 


Call the getValueLength() method 


Result is 02h 




5 




Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 02h, 
DCS = 00h 

Text String TLV = 0D 03 00 "BB" 






Call the getTextStringCodingSchemeO 
method 


Result is OOh 




6 


Call the getValueLength() method 


Result is 03h 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = 0D 7F 08 01 02 ... 7E 








Call the getTextStringCodingSchemeO 
method 


Result is 08h 




8 


Call the getValueLength() method 


Result is 7Fh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = 0D 81 80 04 01 02 ... 7F 






Call the getTextStringCodingSchemeO 
method 


Result is 04h 




10 


Call the getValueLength() method 


Result is 80h 
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11 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 08h 

Text String TLV = 0D 81 FO 08 01 02 ... EE 
EF 






Call the getTextStringCodingSchemeO 
method 


Result is 08h 




12 


Call the getValueLength() method 


Result is FOh 




13 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with 2 Text String TLV 

1st Text String TLV = 0D 02 04 41 
2nd Text String TLV = 0D 03 08 42 43 






Call the getTextStringCodingSchemeO 
method 


Result is 04h 




14 


Call the getValueLength() method 


Result is 02h 





6.2.8.6.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5, 7, 9, 11, 13 


N2 


4, 6, 8, 10, 12, 14 


C1 


1 


C2 


2 



6.2.8.7 Method GetTextStringLength 

Test Area Reference: API_2_PRH_GTTL 
6.2.8.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getTextStringLength ( ) 

throws ToolkitException 

Normal execution 

CRRN1: The getTextStringLength() method returns the text string length value from the first Text String TLV 
element. 

CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

Parameter errors 

No requirements 

Context errors 

CRRC1: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 
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6.2.8.7.2 Test Suite files 



Test Script: 


API_ 


.2. 


_PRH_ 


_GTTL_ 


T.scr 


Test Applet: 


API. 


_2_ 


_PRH_ 


_GTTL_ 


_l.java 


Load Script: 


API. 


.2. 


_PRH_ 


_GTTL_ 


.l.ldr 


Cleanup Script: 


API. 


.2. 


_PRH_ 


_GTTL_ 


.l.clr 



6.2.8.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 






Call to getTextStringLength() with unavailable 
Text String TLV 


UNAVAILABLEELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = 0D 00 








Call the getTextStringLength() method 


Result is OOh 




3 


Call the getValueLength() method 


Result is OOh 




4 






Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = 0D 02 04 "A" 






Call the getTextStringLength() method 


Result is 01 h 




5 


Call the getValueLength() method 


Result is 02h 




6 




Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = 0D 03 00 "BB" 









Call the getTextStringLength() method 


Result is 02h 




7 


Call the getValueLength() method 


Result is 03h 




8 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = 0D 7F 08 01 02 ... 7E 








Call the getTextStringLength() method 


Result is 7Eh 




9 


Call the getValueLength() method 


Result is 7Fh 




10 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = 0D 81 80 04 01 02 ... 7F 








Call the getTextStringLengthQ method 


Result is 7Fh 
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11 


Call the getValuel_ength() method 


Result is 80h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 04h 

Text String TLV = 0D 81 FO 04 01 02 ... EE 
EF 








Call the getTextStringLength() method 


i — \ l ■ ■ i — i — ■ 

Result is EFh 




13 


Call the getValueLength() method 


Result is FOh 




14 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 






Call the getTextStringLength() method 


Result is 01 h 




15 


Call the getValueLengthQ method 


Result is 02h 





6.2.8.7.4 Test Coverage 



CRR number 


Test case number 


1 


2, 4, 6, 8, 10, 12, 14 


2 


3, 5, 7, 9, 11, 13, 15 


3 


1 



6.2.8.8 Method getTheHandler 

Test Area Reference: API_2_PRH_GTHD 

6.2.8.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveResponseHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRN1: The method shall return the single system instance of the ProactiveHandler class. 
CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

Parameter errors 

No requirements 

Context errors 

CRRC1: The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 

6.2.8.8.2 Test Suite files 

Test Script: API_2_PRH_GTHD_l.scr 
Test Applet: API_2_PRH_GTHD_1 .java 
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Load Script: API_2_PRH_GTHD_l.ldr 
Cleanup Script: API_2_PRH_GTHD_l.clr 



6.2.8.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Proactive Command 




Proactive Command 




Terminal Response 








getTheHandler() twice 


The returned objects shall be the 
same 




2 


getTheHandler() 


The reference shall be a 
ProactiveResponseHandler 




3 


getTheHandlerQ 


The reference shall not be null 





6.2.8.8.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2, 3 


N2 


To be checked in 
Framework tests and 
insert here cross 
reference 


C1 


To be checked in 
Framework tests and 
insert here cross 
reference 



6.2.8.9 Method getLength 

Test Area Reference API_2_PRH_GLEN 

6.2.8.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRN1: returns the length in bytes of the TLV list. 

Parameter errors 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_A VAIL ABLE. 



6.2.8.9.2 Test Suite files 



Test Script: 


API_ 


2. 


_PRH_ 


_GLEN_ 


_l.scr 


Test Applet: 


API. 


_2_ 


_PRH_ 


_GLEN_ 


_l.java 


Load Script: 


API_ 


_2_ 


_PRH_ 


_GLEN_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_PRH_ 


_GLEN_ 


.l.clr 
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6.2.8.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandler() 

getLength ( ) 


Result of getLength() is 12 




2 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandler() 
getLength() 


Result of getLength() is FFh 





6.2.8.9.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for 
Proactive Response 
Handler 



6.2.8.10 Method copy 

Test Area Reference API_2_PRH_COPY_BSS 

6.2.8.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRN1: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.8.10.2 Test Suite files 

Test Script: API_2_PRH_COPY_BSS_l.scr 
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Test Applet: API_2_PRH_COPY_BSS_l.java 
Load Script: API_2_PRH_COPY_BSS_l.ldr 
Cleanup Script: API_2_PRH_COPY_BSS_l.clr 



6.2.8.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Additional 
Information in General Result TLV: 

81 03 01 21 00 02 02 82 81 03 01 00 






ProactiveResponseHandler.getTheHandler() 
copy() with NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 13 
dstOffset = 
dstLength = 13 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 12 
dstOffset = 
dstLength = 12 


Result of copy() is 12 




9 


Compare the buffer with buffer: 

81 03 01 21 00 02 02 82 81 03 01 00 


Result of arrayCompare() is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copy() is 15 




11 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

03 01 00 

OF 10 11 12 13 


Result of arrayCompare() is 




12 


Initialize dstBuffer 

dstBuffer = OOh Olh 02h ... 13h 








Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 9 


Result of copy() is 12 




13 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

0C 0D 0E 

OF 10 11 12 13 


Result of arrayCompare() is 





ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 201 ETSI TS 101 955 V8.0.0 (2002-09) 



6.2.8.10.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.8.11 Method findTLV 

Test Area Reference API_2_PRH_FINDBB 

6.2.8.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRN1: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRP1: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException B AD_INPUT_P AR AMETER . 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 



6.2.8.11.2 Test Suite files 



Test Script: 


API_ 


_2_ 


PRH 


_FINDBB_ 


_Lscr 


Test Applet: 


API_ 


2. 


PRH 


_FINDBB_ 


_l.java 


Load Script: 


API_ 


_2_ 


PRH 


_FINDBB_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


PRH 


_FINDBB_ 


.l.clr 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 202 ETSI TS 101 955 V8.0.0 (2002-09) 



6.2.8.11.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 General Result TLV 

82 02 82 81 
03 01 00 
03 02 01 12 








findTLV() with Invalid input parameter 

occurrence = 


ToolkitException.BAD INPUT P 
ARAMETER is thrown 




2 


Search 1st TLV 

tag = Olh 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLength() method 


Result is 03h 




4 


Search 2nd TLV 

tag = 02h 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLength() method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

tag = 04h 
occurrence = 1 


Result is TLVNOTFOUND 




7 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown 




8 


Search a tag with wrong occurrence 

tag = Olh 
occurrence = 2 


Result is TLV NOT FOUND 




9 


Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown. 




10 


Search 3rd TLV 

tag = 03h 
occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 




11 


Call the getValueLength() method 


Result is 01 h 




12 


Search 3rd TLV 

tag = 03h 
occurrence = 2 


Result is 

TLV FOUND CR NOT SET 




13 


Call the getValueLength() method 


Result is 02h 




14 


Search tag 83h 

Tag = 83h 
Occurrence = 1 


Rssult is 

TLV_FOUND_CR_NOT_SET 




15 


Search tag 82h 

Tag = 82h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 





6.2.8.11.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5, 11, 13 


N2 


2, 4 


N3 


10, 12 


N4 


6, 7,8, 9 


N5 


14,15 


P1 


1 


C1 


Does not apply for 
Proactive Response 
Handler 



6.2.8.12 Method getValueLength 

Test Area Reference API_2_PRH_GVLE 
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6.2.8.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRN1: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.8.12.2 Test Suite files 

Test Script: API_2_PRH_GVLE_l.scr 
Test Applet: API_2_PRH_GVLE_l.java 
Load Script: API_2_PRH_GVLE_l.ldr 
Cleanup Script: API_2_PRH_GVLE_l.clr 
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6.2.8.12.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response 

Text String TLV = 0D 00 








ProactiveResponseHandler.getTheHandler() 

GetValueLength () 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




2 


Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = 0D 02 04 41 









Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = 0D 7F 04 01 02 ... 7E 








Search TLV ODh (Text String TLV) 









getValueLength ( ) 


Result is 7Fh 




5 


Send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response, Text String length = 7Fh 

Text String TLV = 0D 81 80 04 01 02 ... 7E 
7F 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 80h 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = 0D 81 F0 04 01 02 ... EF 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is FOh 





6.2.8.12.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for 




Proactive Response 




Handler 


C2 


1 



6.2.8.13 Method getValueByte 

Test Area Reference API_2_PRH_GVBYS 
6.2.8.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte ( short valueOffset) 
throws ToolkitException 
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Normal execution 

CRRN1: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRP1: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES . 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.13.2 Test Suite files 



Test Script: 


API. 


_2_ 


_PRH_ 


_GVBYS_ 


_l.scr 


Test Applet: 


API. 


_2_ 


_PRH_ 


_GVBYS_ 


_l.java 


Load Script: 


API. 


.2. 


_PRH_ 


_GVBYS_ 


_l.ldr 


Cleanup Script: 


API. 


_2_ 


_PRH_ 


_GVBYS_ 


l.clr 



6.2.8.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = 0D 7F 04 01 02 ... 7E 








ProactiveResponseHandler.getTheHandler() 








getValueByte (0) 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte (3) 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte (2) 


Result is OOh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 82h (Source) 




5 


Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = 0D 81 F0 04 01 02 ... 7E 
7F ... EF 








Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




7 


GetValueByte (7F) 


Result is 7Fh 




8 


GetValueByte (EF) 


Result is EFh 
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6.2.8.13.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 




Proactive Response 




Handler 


C2 


1 



6.2.8.14 Method copyValue 

Test Area Reference API_2_PRH_CPYVS_BSS 
6.2.8.14.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.14.2 Test Suite files 



Test Script: 


API_ 


_2_ 


_PRH_ 


CPYVS. 


_BSS_ 


.l.scr 


Test Applet: 


API. 


_2_ 


_PRH_ 


CPYVS. 


_BSS_ 


.l.java 


Load Script: 


API. 


_2_ 


_PRH_ 


CPYVS. 


_BSS_ 


.l.ldr 


Cleanup Script: 


API_ 


_2_ 


_PRH_ 


CPYVS. 


_BSS_ 


.l.clr 
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6.2.8.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = 0D 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandler() 

Select Text String TLV 








Pri'n\7\7a 1 i i / \ t*7 t'HVi nn 1 1 rJ q h Pn "F "F^r 
v.UJJy V alUc \ / Wl Lll Cl 11LI_L_L Uo LDLll lei 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

clstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer. length 

dstBuffer.length = 5 
dstOffset = 

Ub LliCliy Lll — O 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




/-» 

D 


dstLength < u 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


ValueOffset + dstLength > Text String length 

ValueOffset = 2 
DstBuffer.length = 15 
DstOffset = 
DstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler 








CopyValue ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


Select Text String TLV 








^ur*r*PQQful call 

ValueOffset = 
DstBuffer.length = 17 
DstOffset = 
DstLength = 17 


ncoun ui ou|jy vciiuc^ io i / 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

ValueOffset = 2 


Result of copyValue() is 15 
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DstBuffer . length = 20 

UbLUllocL — O 

DstLength = 12 






15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB 0C 
55 55 55 55 55 


Result is OOh 





6.2.8.14.4 Test Coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14 


P1 


1 


P2 


L 2, 3, 4, 5, 6 j 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Response 




Handler 


C2 


11 



6.2.8.15 Method compareValue 

Test Area Reference API_2_PRH_CPRVS_BSS 
6.2.8.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue ( short valueOffset, 

byte [ ] compareBuf f er , 
short compareOf f set , 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

Compares the last found TLV element with a buffer: 
CRRN1: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 
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CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.15.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.15.3 



Test Suite files 

API_2_PRH_CPRVS_BSS_1 .scr 
API_2_PRH_CPRVS_BSS_1 .java 
API_2_PRH_CPRVS_BSS_1 .ldr 
API_2_PRH_CPRVS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = 0D 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandler() 

beiect i ext btnng ij_iv 








compareValue() with a null compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


vdiucui ibci > icxi oiling Lcnyin 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


TrtrJU-itE vr^or»tir*n Ol IT Tl \/ 
I OUIKIItXCGpilOn.^U I wr I LV 

BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 
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Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








CompareValue ( ) 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




12 


Select Text String TLV 








Initialise* mmnarpRuffpr 

CompareBuffer = 
04 00 01 ... OF 








Comnarp huffprs 

ValueOffset = 
CompareOf f set = 
CompareLength = 17 


Rpqnlt ic f)0h 




13 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Cnmnarp huffpr^ with ump naramptpi*^ 


RpQI lit IQ J-1 

ncoui i lo ti 




15 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 6 07 
08 09 OA 0B 0C 
55 55 55 55 55 









Compare buffers 

ValueOffset = 2 
CompareOf f set = 3 

fnmna roT.pnnt" h = 19 

\^ {J 1 L L kJ Cll CLiCHm Lit — 1 i 


Result is OOh 




1 fi 


Initiali^p mmnarpRuffpr 

llll IICIIIOC uUII IUQI C UU MCI 

CompareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








finmnarp huffprs with samp narampfprs 

Vwl 1 IUQI C UUIICIO VVIIII OCII 1 IC UHl QMICICI o 


RpQI I It IQ - 1 




17 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA 0D 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





6.2.8.15.4 Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Response 




Handler 


C2 


11 



6.2.8.1 6 Method findAndCopyValue(byte tag, byteQ dstBuffer, short ValueOffset) 

Test Area Reference API_2_PRH_FACYB_BS 
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6.2.8.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

CRRN1: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UN A VAIL AB LE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 



6.2.8.16.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.16.3 



Test Suite files 

API_2_PRH_FACYB_BS_1 .scr 
API_2_PRH_FACYB_BS_1 .java 
API_2_PRH_FACYB_BS_1 .ldr 
API_2_PRH_FACYB_BS_1 xlr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = 0D 10 04 01 02 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








FindAndCopyValue ( ) with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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dstOffset = 5 






6 


Send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler() 








Select a TLV (tag 02h) 









findAndCopyValue() 

tag = 04h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




7 


Successful call 

Tag = ODh 

DstBuffer . length = 17 
DstOffset = 


Result of findAndcopyValue() is 
17 




8 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

DstBuffer . length = 20 
DstOffset = ? 


Result of findAndcopyValue() is 
19 




10 


Compare buffer 

Buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 


Result is OOh 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

0D 11 04 00 01 ... OF 

OD 02 04 41 








ProactiveResponseHandler.getTheHandler() 









Successful call 

Tag = ODh 

DstBuffer . length = 17 
DstOffset = 


Result of findAndcopyValue() is 
17 




12 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




13 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler() 








Successful call (with tag 8Dh) 

Tag = 8Dh 

DstBuffer . length = 17 
DstOffset = 


Result of findAndcopyValue() is 
17 




14 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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PRR nurnhpr 
vnn i iui i iuci 


1 Col lidOC IIUIIIUCI 


N1 
in i 


O, I U. I c 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PRH_FACYBBS_BSS 

6.2.8.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
Toolkit Except ion 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.8.17.2 Test Suite files 

Test Script: API_2_PRH_FACYBBS_BSS_l.scr 
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Test Applet: API_2_PRH_FACYBBS_BSS_l.java 
Load Script: API_2_PRH_FACYBBS_BSS_l.ldr 
Cleanup Script: API_2_PRH_FACYBBS_BSS_l.clr 



6.2.8.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = 0D 10 04 01 02 ... OF 









r rudcu vcricopons&naniji&r.gci i nenanaier^ 






findAndCopyValue() with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 

\J. O Lvl 1 OC U -L 

dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


d^tLpnath ■> d^tBuffpr Ipnath 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArrPvlnrlpyOi itOfRoi inrl^Fyppntin 

r^l Idyll UCAWU UUU Uol — AOC|ufll \J 

n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = 0D 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandler() 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT_OF_TLV_ 

t~t f~~\ i im r~\ a i — \ ii — (—i ■ ■ i 

BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 






ProactiveResponseHandler.getTheHandler() 








Select a TLV (tag 02h) 
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findAndCopyValue() 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




12 


Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer . length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValue() is 
17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 2 
DstBuff er . length = 20 
DstOffset = 3 
DstLength = 12 


Result of findAndcopyValue() is 
15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 


Result is OOh 




16 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

0D 11 04 00 01 02 ... OF 

0D 06 00 11 22 33 44 55 (no specific DCS 
byte) 








ProactiveResponseHandler.getTheHandler() 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer . length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValue() is 
17 




17 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

Tag = ODh, occurrence = 2 
ValueOffset = 
DstBuff er . length = 6 
DstOffset = 
DstLength = 6 


Result of findAndCopyValue() is 
6 




19 


Compare buffer 

Buffer = 00 11 22 33 44 55 


Result is OOh 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 









ProactiveResponseHandler.getTheHandler() 








Successful call (with tag 8Dh) 

Tag = 8Dh, occurrence = 1 
ValueOffset = 
DstBuffer . length = 17 
DstOffset = 
DstLength = 17 


Result of findAndcopyValue() is 
17 




21 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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PRR nurnhpr 
vnn i iui i iuci 


1 Col lidOC IIUIIIUCI 


IN I 


r 1Q IK 17 1Q 

I O, I J, \l, I 3 


MO 


1 1 


N3 


12, 14, 16, 18 


N4 


20, 21 


P1 


1 


[ P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.8.18 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference API_2_PRH_FACRB_BS 

6.2.8.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRN1: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

6.2.8.18.2 Test Suite files 

Test Script: API_2_PRH_FACRB_BS_l.scr 
Test Applet: API_2_PRH_FACRB_BS_1 .java 
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Load Script: API_2_PRH_FACRB_BS_l.ldr 
Cleanup Script: API_2_PRH_FACRB_BS_l.clr 



6.2.8.18.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = 0D 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandler() 








FindAndCompareValue() with a null dstBuffer 


NullPointerException is thrown 




2 


rnmnarpOff <spt mmnarpRuffpr Ipnnth 

tag = ODh 

compareBuff er . length = 20 
compareOf f set = 21 


ArravlnrlpyOi itOfRni inrl^Fyrpntin 

n is thrown 




3 


compareOffset < 

compareBuf fer . length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer. length 

compareBuf fer . length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + length > 

;~'f~sTn"T~i;3"K~£iRi~iT 7 T 7 £i"K~ 1 <^ n rrT~ In 

1 L L yj Cll CDLll 1C1 . 1C11U Lll 

CompareBuf fer . length = 20 
CompareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is inrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler() 








Select a TLV (tag 02h) 









findAndCompareValue() 

tag = 04h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 







Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




7 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers 

Tag = ODh 
CompareOffset = 


Result is OOh 




8 


Verify current TLV 

GetValueLength () 


Result is 17 




9 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialise compareBuffer 

CompareBuffer = 
03 00 01 ... OF 









Compare buffers with same parameters 


Result is +1 




11 


Initialise compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 








Compare buffers 

CompareOffset = 2 


Result is OOh 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

0D 11 04 00 01 ... OF 
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OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandler() 








Initialise compareBuffer 

rnmi^^rpRii'F'Fp'r — 

"wUll L kJ al CDUl ici — 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 








Compare buffers 

rnmna roOf f cot" = 

V 1 L L kJ CIlCvllOCL — ^ 


Result is OOh 




13 


Initialise compareBuffer 

Primria rpRn f f pr = 
LUll L kJ al CD ui 1 Ci — 

55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0E OF 55 









Compare buffers 

rnmnarpOf f qpt = 

V 1 L L kJ Cll Cvl 1 OU L — ^ 


Result is -1 




14 


Initialise compareBuffer 

C omp 3r"sBuffs-f = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA 0B 
0C 0D 0D 10 55 








Compare buffers 

CompareOf f set = 2 


Result is +1 




15 


Send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler() 








Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

Tag = 8Dh 
CompareOf f set = 


Result is OOh 





6.2.8.18.4 Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


L N6 


15 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.8.19 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PRH_FACRBBS_BSS 
6.2.8.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 
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byte occurence, 
short valueOffset, 
byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitExcept ion 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRN1: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRP1: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException B AD_INPUT_P AR AMETER. 

Context errors 

CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 



6.2.8.19.2 Test Suite files 



Test Script: 


API. 


_2_ 


PRH 


_FACRBBS_ 


_BSS_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


PRH 


_FACRBBS_ 


_BSS_ 


_l.java 


Load Script: 


API_ 


_2_ 


PRH 


_FACRBBS_ 


_BSS_ 


l.ldr 


Cleanup Script: 


API. 


_2_ 


PRH 


_FACRBBS_ 


_BSS_ 


l.clr 
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6.2.8.19.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 






ProactivpRp^non^pHandlpr nptThpHandlprH 








findAndCompareValue() with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer. length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 







CompareOffset + compareLength 

>compareBuf f er . length 
CompareBuffer . length = 5 
CompareOffset = 3 
CompareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response, Text String length = 5 

Text String TLV = 0D 06 04 01 02 ... 05 









ProactiveResponseHandler.getTheHandler() 






valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




1 


valu^Off^Pt + romnarpLpnath ^» Tpxt Strina 

v mucw i i -j v — i t w 1 1 1 kj n i v — i_ i — 1 1 y 1 1 1 . — i i — /\ i »_/ 1 1 ■ ■ iu 

length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


TnnlkitFxrpntinn Ol IT OF Tl V 
BOUNDARIES is thrown 




11 


Invalid parameter 

Occurrence = 


ToolkitException.BAD_INPUT_P 
ARAMETER is thrown 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler() 








Select a TLV (tag 02h) 
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findAndCompareValue() 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLength() method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




13 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 









findAndCompareValue() 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

GetValueLength () 


Result is 17 




15 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 









Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA 0B 0C 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA 0D 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

0D 11 04 00 01 ... OF 

0D 06 00 11 22 33 44 55 









ProactiveResponseHandler.getTheHandler() 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValue() 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValue() 


Result is OOh 
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uay — \juiL/ <j i^, i^, n _i_ j_ ci i l. tr — z. 

valueOffset = 
compareOf f set = 
compareLength = 6 






22 


Initialise compareBuffer 

compareBu f f sir = 
00 11 22 33 44 66 








findAndCompareValue() 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = 0D 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler() 








IIIILIdlloC UUI IIUCII CDUIICI 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 





6.2.8.19.4 Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17, 20, 21 


L N4 


15, 18, 22 


N5 


16, 19 


N6 


23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.9 Class ToolkitRegistry 
6.2.9.1 Method allocateTimer 

Test Area Reference: API_2_TKR_ATIM 

6.2.9.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte allocateTimer ( ) throws ToolkitException 

Normal execution 

CRRN1: the returned timer identifier shall be between 01 and 08 inclusive. 

CRRN2: the returned timer identifier shall be different from a previously allocated but not released one. 
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CRRN3: The SIM Toolkit Framework shall trigger the applet when receiving an ENVELOPE(TIMER 
EXPIRATION) command for the allocated timer. 

CRRN4: A call to isEventSet() method for EVENT_TIMER_EXPIRATION should return true if the applet has at 
least one timer allocated. 

Parameters error 

No requirements 

Context errors 

CRRC1: Shall throw a ToolkitException with reason NO_TIMER_A V AIL AB LE if all the timers are allocated. 

CRRC2: Shall throw a ToolkitException with reason NO_TIMER_A VAIL ABLE if the maximum number of 
timers have been allocated to this applet according to installation parameter. 

6.2.9.1.2 Test suite files 

Test Script: API_2_TKR_ATIM_l.scr 
Test Applet: API_2_TKR_ATIM_l.java 

API_2_TKR_ATIM_2.java 

API_2_TKR_ATIM_3 j ava 
Installation parameters: 

For this test procedure the non-volatile memory of each instance is 200 (Hexa). 
The maximum timer parameter value is as follows for each applet: 

- applet 1 (API_2_TKR_ATIM_1): 8 timers 

- applet 2 (API_2_TKR_ATIM_2): 4 timers 

- applet 3 (API_2_TKR_ATIM_3): timer 
Load Script: API_2_TKR_ATIM_l.ldr 

The load script installs the 6 instances. 
Cleanup Script: API_2_TKR_ATIM_l.clr 
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6.2.9.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 timers 
(applet 1) 

8 * allocateTimer ( ) . 


No exception shall be thrown. 
Timer ID returned shall be between 
01 and 08 inclusive. It shall be 
different after each call. 




2 


Allocate timers more than the maximum 
(applet 1) 

TVio annl pt" 1 a 1 1 n^atpo 1 mnrp t~ ~i m(=i t~ 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 




3 


Check applet is Triggered by 
ENVELOPE(TIMER_EXPIRATION) command 
(appletl) 

Send ENVELOPE (TIMER EXPIRATION) with all 
timers id (not in an increase order) . 

Calls releaseTimer ( id) each time a timer 
expires . 


Shall trigger each time an 
ENVELOPE(TIMER EXPIRATION) 
is sent to the SIM, for Timer ID = 
'01 'to '08'. 




4 


Allocate up to 4 timers 
(applet 2) 

4 * allocateTimer () . 


No exception shall be thrown. Each 
time, the returned timer identifier 

shall be between '01' and '08' 
inclusive. It shall be different after 
each call. 




5 


Allocate timers more than the maximum 
(applet 3) 

The applet 3 allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 





6.2.9.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,4 


N2 


1,4 


N3 


3 


N4 


1 


C1 


2 


C2 


5 



6.2.9.2 Method changeMenuEntry 

Test Area Reference: API_2_TKR_CMETB_BSSBZBS 
6.2.9.2.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void changeMenuEntry (byte id, 

byte[] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte iconQualif ier , 
short iconldentif ier ) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitException 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



225 



ETSI TS 101 955 V8.0.0 (2002-09) 



Normal execution 

CRRN1: The SIM Toolkit Framework shall dynamically update the menu stored in the ME by issuing a SET UP 
MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

CRRN2: The default state of the changed menu entry is 'enabled'. 

CRRN3: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true before and after the call. 

CRRN4: if helpSupported was true then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

CRRN5: if helpSupported was true then after the completion of the SETUP MENU command, if an 

ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

CRRN6: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 
command qualifier = '80' 

CRRN7: if helpSupported was false and if no entries is supporting help then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return false . 

CRRN8: if helpSupported was false and if no entries is supporting help then after the completion of the SETUP 
MENU command, if an ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the 
SIM, then the SIM Toolkit framework shall not trigger the applet. 

CRRN9: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 

provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

CRRN10: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRN11: If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 

MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to as defined in GSM 1 1 . 14 [4] . 

Parameters error 

CRRP1: Shall throw java.lang.NullPointerException - if menuEntry is null 

CRRP2: Shall throw java.lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

CRRP3: Shall throw java.lang.ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds 

CRRP4: Shall throw java.lang.ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 

Context errors 

CRRC1: Shall throw a ToolkitException with MENU_ENTRY_NOT_FOUND reason if the Menu Identifier isn't 
associated to the calling applet instance. 

CRRC2: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 

6.2.9.2.2 Test suite files 

Additional requirements for the GSM personalisation: 
- content of EF sume shall be: 
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- Title Alpha Identifier: "TOOLKIT TEST" 

Test Script: API_2_TKR_CMETB_BBSSBZBS_l.scr 
Test Applet: API_2_TKR_CMETB_BBSSBZBS_l.java 

- entry '01' is "Initl" 

- entry '02' is "Init2" 
Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 
Maximum number of menu entries: 2 

- Position / Identifier for each menu entry: 'OIV'0 1702702' 
Load Script: API_2_TKR_CMETB_BBSSBZBS_l.ldr 
Cleanup Script: API_2_TKR_CMETB_BBSSBZBS_l.clr 
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6.2.9.2.3 



Test procedure 



1 



Description 



API Expectation 



APDU Expectation 



Applet changes the entry's title by menuEntry 
buffer, with a greater length than the initial 
length 

1- ChangeMenuEntry ( ) with parameters: 
Id = 1 02 1 

MenuEntry = "UseAllBuf f er " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- shall return true. 

3- shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 



Changing the title with part of menuEntry 
buffer 

1- ChangeMenuEntry () with parameters: 
Id = 1 01 ' 

MenuEntry = "UsePartOf Buf f er " 
Offset = 3 
Length = 12 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'01'. 



Length = 

1- ChangeMenuEntry ( ) for entry '01' and 
entry '02', with parameters: 

Id = ' 01 ' / ' 02 ' 

MenuEntry = "LengthEqualsO" 
Offset = 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- Shall return true. 

3- shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
for entry '01 'and entry '02', 
no text part. 



Setting a next action indicator != 



1- ChangeMenuEntry () with parameters: 
Id = ' 02 ' 

MenuEntry = "NextActionlndic" 
Offset = 

Length = menuEntry . length 
NextAction = '10' (SETUP CALL) 
HelpSupported = false 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains an 
Items Next Action Indicator 
list and which contains a 
command qualifier '80'. 
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IconQualif ier = 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 

4- changeMenuEntry ( ) with parameters: 
Id = 1 02 1 

MenuEntry = "NextActionlndic" 
Offset = 

Length = menuEntry . length 
NextAction = '10' (SETUP CALL) 
HelpSupported = true 
IconQualif ier = 
Iconldentif ier = 



Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '02' 



Applet is trigged by a 
MENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 02 



help supported=true 



1- changeMenuEntry () with parameters: 
Id = ' 01 ' 

MenuEntry = "HelpSupported" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = true 
IconQualif ier = 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains a 
command qualifier '80'. 



Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '01' 



Applet is trigged by a 
MENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 01 



Setting icons, help supported = false 

1- changeMenuEntry ( ) for entries 
' 01 ' , ' 02 ' , with parameters : 

Id = ' 01 ' / ' 02 ' 

MenuEntry = " IconQualif ier " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = '01' 
Iconldentif ier = '02' / '01' 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains an 
Icon Identifier List. 



MenuEntry is disabled 

1- disableMenuEntry ( ' 01 ' ) . 

2- changeMenuEntry () with parameters: 



1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall return true. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the entry. Without Icon 
identifier List Simple TLV 
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Id = ' 01 ' 

MenuEntry = "EnableEntry " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

3- isEventSet (EVENT_MENU_SELECTION) . 

4- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


4- Shall return false. 




10 


MenuEntry is null 

changeMenuEntry ( ) with : 
MenuEntry = NULL 


Shall throw 

java.lang.NullPointerException. 




11 


Offset causes access outside array bounds 

Id = 1 01 ' 

MenuEntry = "Violation" 
Offset = menuEntry . length +1 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




12 


Big Offset causes access outside array bounds 

Id = 1 01 ' 

MenuEntry = "Violation" 
Offset = 255 
Length = 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




13 


Offset < causes access outside array bounds 

Id = 1 01 ' 

MenuEntry = "Violation" 
Offset = -1 
Length = 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




14 


Length causes access outside array bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 
Offset = 

Length = MenuEntry . length + 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




15 


Length < causes access outside array 
bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 
Offset = 
Length = -1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 


Qhqii thrnw 

Ol 1 CU 1 LI 1 1 U VV 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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16 


Both offset and length causes access outside 
array bounds 

Id = 1 01 1 

Me^ nnPni" r\; = " \ 7 ~i r~il 3 "h "i nn " 

Offset e [1, MenuEntry . length] 
Length = MenuEntry . length 
NextAction = 1 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




17 


Invalid ID used 

Id = ' 00 ' 

MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length < 16 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitException with 
MENU_ENTRY_NOT_FOUND 
reason code. 




18 


ID isn't allocated to a menu entry of this applet 
instance 

Id = ' OA' 

MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length < 16 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 

MENU_ENTRY_NOT_FOUND. 




19 


The text is bigger than the allocated space 

Id = ' 02 ' 

MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length > 15 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 

ALLOWEDLENGTHEXCEEDED. 




20 


With a smaller text length than the initial length 

1. changeMenuEntry ( ) with parameters: 
Id = ' 02 ' 

MenuEntry = "Init" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

2 . isEventSet (EVENT_MENU_SELECTION) 
3. 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 . No exception shall be thrown. 

2. Shall return true. 

3. Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 
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6.2.9.2.4 Test Coverage 
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8 
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P1 


10 


P2 


11,12,13 


P3 
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P4 


16 


C1 


17,18 


C2 


19 



6.2.9.3 Method clearEvent 

Test Area Reference: API_2_TKR_CEVTB 
6.2.9.3.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void clearEvent (byte event) 

throws ToolkitException 

Normal execution 

CRRN1: A call to isEventSet() method for a cleared event should return false after a call to clearEvent. 

CRRN2:The SIM Toolkit Framework shall not trigger the applet on the occurrence of the cleared event anymore. 

CRRN3: if event was EVENT_CALL_CONTROL_BY_SIM and after the call, no applet is registered to it, The SIM 
Toolkit Framework shall allow an applet to register to this event. 

CRRN4: if event was EVENT_CALL_CONTROL_BY_SIM and one applet is still registered to these event, The 
SIM Toolkit Framework shall not allow an applet to register to this event. 

CRRN5: if event was EVENT JVIO_SHORT_MESSAGE_CONTROL_BY_SIM and after the call, no applet is 
registered to it, The SIM Toolkit Framework shall allow an applet to register to this event. 

CRRN6: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM and one applet is still registered to 
these event, The SIM Toolkit Framework shall not allow an applet to set this event. 

Parameters error 

CRRP1: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION. 

CRRP2: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP3: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_TIMER_EXPIRATION. 
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CRRP4: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_STATUS_COMMAND. 

Context errors 

No requirements 

6.2.9.3.2 Test suite files 

Test Script: API_2_TKR_CEVTB_l.scr 

Test Applet: API_2_TKR_ CEVTB _\ .java 

As default but applet registers to an event list which contains all defined events in GSM 03.19 [7] excepted 
those that aren't allowed or supported by setEvent(). 

Load Script: API_2_TKR_ CEVTB_1 .ldr 

Cleanup script: API_2_TKR_ CEVTB_1 .clr 



6.2.9.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear ALLOWED unregistered events 

For events ranging from 1 to 127 excepted 
those that aren't allowed 
(EVENT_MENU_SE LECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_TIMER_EXP I RAT I ON, 
EVENT_STATUS_COMMAND) , 
the applet calls: 

1- clearEvent ( ) method 

2- isEventSetO method 


1 - No exception is thrown each 
time. 

2- Shall return false each time. 




2 


Clear registered events 

1- For each ALLOWED and SUPPORTED events, 
the applet calls setEvent() method. 

2- For events ranging from 1 to 127 
excepted those that aren't allowed, the 
applet calls: 

2.1- clearEvent () method 

2.2- isEventSetO method 


1 - No exception shall be thrown. 

2.1- No exception shall be thrown. 

2.2- Shall return false. 




3 


Clearing NOT ALLOWED events 

For each event among: 
EVENT_MENU_SE LECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_TIMER_EXP I RAT I ON, 
EVENT_S T ATU S_COMMAND 

1- The applet calls clearEvent (event ) 
method . 


1 - Each time, clearEvent shall 
throw a Toolkit Exception with 
reason EVENT NOT ALLOWED. 




4 


Checking applet isn't triggered by an 
ENVELOPE(SMS-PP DOWNLOAD) command 

1 - reset and initialise the card 

2 - An ENVELOPE (SMS-PP DOWNLOAD) is sent 
with a TAR referencing applet. 


Applet is not trigged by an 
ENVELOPE(SMS-PP 
DOWNLOAD) command 
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6.2.9.4 Method disableMenu Entry 

Test Area Reference: API_2_TKR_DMETB 

6.2.9.4.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void disableMenuEntry (byte id) 
throws ToolkitException 

Normal execution 

CRRN1: A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before and 
after the call to disableMenuEntry() method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the same 
result before and after the call to disableMenuEntry() method. 

CRRN3: After invocation of this method the SIM Toolkit Framework shall dynamically update the menu stored in 
the ME. 

CRRN4: After invocation of this method, if there is no more enabled menu entries then the SIM Toolkit framework 
shall issue a SETUP MENU proactive command containing Item Data Object for Item 1 TLV with a length of 
zero and no value part. 

Parameters error 

No requirements 

Context errors 

CRRC1: shall throw a ToolkitException with reason = ENTRY_NOT_FOUND if the menu entry doesn't exist for 
this applet 

6.2.9.4.2 Test suite files 

Additional requirements for the GSM personalisation: 
- content of EF sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_DMETB_l.scr 
Test Applet: API_2_TKR_DMETB_l.java 
Installation parameter: 

Same as default applet but with: 
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Maximum text length for a menu entry: 15 
Maximum number of menu entries: 2 
- Position / Identifier for each menu entry: '0 1 70 1 ', '02V02' 

Load Script: API_2_TKR_DMETB_l.ldr 

Cleanup script: API_2_TKR_DMETB_l.clr 



6.2.9.4.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check the menu state before 
disabling a previously enabled entry 
not registered to 
EVENT_MENU_SELECTION HELP REQUEST 

1- reset and initialise the card 

2- isEventSet (EVENT_MENU_SE LECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- Shall return true 

2- Shall return false 


1 - The SIM shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


2 


Check the menu state after 
disabling a previously enabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- disableMenuEntry ( ' 01 ' ) 

2- isEventSet (EVENT_MENU_SE LECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


3 


Check the menu before 
disabling a previously enabled entry 
registered to 
EVENT J\1ENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- isEventSet (EVENT_MENU_SE LECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


2- Shall return true 

3- Shall return true 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02', 
indicating help supported. 


4 


Check the menu after 
disabling a previously enabled entry 
registered to 
EVENT JVIENU_SELECTION_HELP_REQUEST 

1- disableMenuEntry (' 02 ' ) 

2- isEventSet (EVENT_MENU_SE LECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with 1st Item TLV 
with a length of 0. 


5 


Disabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
disableMenuEnt ry ( ID ) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 
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6.2.9.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


2,4 


N4 


4 


C1 


5 



6.2.9.5 Method enableMenuEntry 

Test Area Reference: API_2_TKR_EMETB 

6.2.9.5.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void enableMenuEntry (byte id) 
throws ToolkitException 

Normal execution 

CRRN1: A call to isEventSet() method on EVENT_MENU_S ELECTION shall return the same result before and 
after the call to enableMenuEntry() method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the same 
result before and after the call to enableMenuEntry() method. 

CRRN3:The SIM Toolkit Framework shall dynamically issue a SETUP MENU proactive command which does 
contain an ITEM SIMPLE TLV object for this entry. 

Parameters error 

No requirements 

Context errors 

CRRC1: shall throw a ToolkitException with reason = MENU_ENTRY_NOT_FOUND if the menu entry doesn't 
exist for this applet 

6.2.9.5.2 Test suite files 

Additional requirements for the GSM personalisation: 
content of EF sume shall be: 
- Title Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_EMETB_l.scr 
Test Applet: API_2_TKR_EMETB_l.java 
Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 
Maximum number of menu entries: 2 
Position / Identifier for each menu entry: '0T/'0T, '02V02' 
Load Script: API_2_TKR_EMETB_l.ldr 
Cleanup script: API_2_TKR_EMETB_l.clr 
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6.2.9.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check menu state before 
enabling a previously disabled entry 
not registered to 
EVENT J\1ENU_SELECTION_HELP_REQUEST 

1- isEventSet (EVENT_MENU_SE LECTION) 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 

3- disableMenuEntry ( ' 01 ' ) 


1- Shall return true 

2- Shall return false 

3- No exception shall be thrown. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


2 


Check menu state after 
enaoiing a previously uisaoiea eniry 
not registered to 
EVENT J\1ENU_SELECTION_HELP_REQUEST 

1- enableMenuEntry ( ' 01 ' ) 

2- isEventSet (EVENT_MENU_SE LECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


3 


Check menu state before 
enabling a previously enabled entry 
registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- isEventSet (EVENT_MENU_SE LECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 

4- disableMenuEntry (' 02 ' ) 


2- Shall return true 

3- Shall return true 

4- No exception shall be thrown 


4- The SIM shall issue a 
SET UP MENU proactive 
command with entry '01'. 
The help information 
available flag. is not verified 


4 


Check menu state after 
enaoiing a previously enaoiea eniry 
registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- enableMenuEntry (' 02 ') . 

2- isEventSet (EVENT_MENU_SE LECTION) 

o — 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entries '01' 
and '02' indicating help 
supported. 


5 


Enabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
enableMenuEntry ( ID ) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





6.2.9.5.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


[ N2 J 


1,2,3,4 


N3 


1,2,3,4 


C1 


5 



6.2.9.6 Method getEntry 

Test Area Reference: API_2_TKR_GETY 
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6.2.9.6.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static ToolkitRegistry getEntryO 
throws ToolkitException 

Normal execution 

CRRN1: returns a reference to the applet ToolkitRegistry object of the calling applet. 
CRRN2: Each successive call to getEntryO method shall return the same object. 
Parameters error 
No requirements 



6.2.9.6.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.6.3 



Test suite files 
API_2_TKR_GETY_1 . scr 
API_2_TKR_GETY_1 .j ava 
API_2_TKR_GETY_1 .ldr 
API_2_TKR_GETY_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Installation 

In the constructor, the applet instance 
calls the getEntryO method. 


Returns a not null ToolkitRegistry 
instance. 




2 


Check it returns the same entry 

The applet calls the getEntryO method 
again . 


Returns the same ToolkitRegistry 
instance as for test case 1 . 





6.2.9.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 



6.2.9.7 Method getPolllnterval 

Test Area Reference: API_2_TKR_GPOL 

6.2.9.7.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getPolllnterval ( ) 

Normal execution 

CRRN1: shall return a value between 1 and 15300 if applet is registered to EVENT_STATUS_COMMAND event. 

CRRN2: shall return POLL_NO_DURATION value (0) if the toolkit applet is not registered to 
EVENT_STATUS_COMMAND event. 
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Parameters error 
No requirements. 

Context errors 

No requirements. 

6.2.9.7.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.7.3 



Test suite files 
API_2_TKR_GPOL_l .scr 
API_2_TKR_ GPOL_l.java 
API_2_TKR_ GPOL_l.ldr 
API_2_TKR_ GPOL_l .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet isn't registered to 
EVENT_STATUS_COMMAND 

getPollInterval ( ) . 


Shall return 0. 




2 


Requesting max duration 

1- requestPollInterval (15300) 

2- Reset and initialize the card 

3- getPollInterval () 


1 - No exception shall be thrown. 

3- Shall return a value between 1 
and 15300. 




3 


Requesting System Duration 

l- 

requestPoll Interval (POLL_SYSTEM_DURATI 

ON) 

2- Reset and initialize the card 

3- getPollInterval () . 


1 - No exception shall be thrown. 
3- Shall return a value between 1 
and 15300. 




4 


Requesting no Duration 

1- requestPollInterval (POLL_NO_DURATION) 

2- Reset and initialize the card 

3- getPollInterval () . 


1 - No exception shall be thrown. 
3- Shall return 0. 





6.2.9.7.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


1,4 



6.2.9.8 Method initMenuEntry 

Test Area Reference: API_2_TKR_IMET_BSSBZBS 
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6.2.9.8.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte initMenuEntry {byte [ ] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte iconQualif ier , 
short iconldentif ier) 
throws java . lang . Nu 1 IP o inter Except ion, 

java . lang . ArraylndexOutOf Bounds Except ion, 
Toolkit Except ion 



Normal execution 

CRRN1: The SIM Toolkit Framework shall automatically update the menu stored in the ME by issuing a SETUP 
MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

CRRN2: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true after the 1 st successful 
call (without an exception). 

CRRN3: if helpSupported was true then a following call to isEventSet() method on 
EVENT JVIENU_SELECTION_HELP_REQUEST event shall return true . 

CRRN4: if helpSupported was true then after the completion of the SETUP MENU command, if an 

ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

CRRN5: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 
command qualifier = '80' 

CRRN6: if helpSupported was false and there isn't any menu entry supporting help then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

CRRN7: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 

provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

CRRN8: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRN9: If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 

MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to 0. 

CRRN10: After the completion of the SETUP MENU command, if an ENVELOPE (MENU_SELECTION) 
command is received by the SIM for this identifier, then the SIM Toolkit framework shall trigger the applet. 

Parameters error 

CRRP1: Shall throw java. lang. NullPointerException - if menuEntry is null 

CRRP2: Shall throw java. lang. ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

CRRP3: Shall throw java. lang. ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds 

CRRP4:Shall throw java.lang. ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 
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Context errors 

CRRC1: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space 

CRRC2: Shall throw REGISTRY_ERROR if the menu entry cannot be initialised (eg no more item data in applet 
loading parameter) 

6.2.9.8.2 Test suite files 

Additional requirements for the GSM personalisation: 
- content of EF sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 
Test case trigger: 1- Applet instantiation 

2- Menu selection 

3- Menu selection Help Supported 

Test Script: API_2_TKR_IMET_BSSBZBS_l.scr 
Test Applet: API_2_TKR_IMET_BSSBZBS_l.java 
Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 
Maximum number of menu entries: 6 

- Position / Identifier for each menu entry: 'Ol'/'Ol', '02702', '03703', '04704', '05705', and '06706' 
Load Script: API_2_TKR_IMET_BSSBZBS_l.ldr 

Cleanup script: API_2_TKR_IMET_BSSBZBS_l.clr 



6.2.9.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to menuEntry 

MenuEntry = NULL 


Shall throw a 

java.lang.NullPointerException. 




2 


Offset > menuEntry.length 

MenuEntry = "ToolkitTest " 
Offset = 12 
Length = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




3 


Offset < 

MenuEntry = "ToolkitTest" 
Offset = -1 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




4 


Offset = 255 

MenuEntry = "ToolkitTest" 
Offset = 255 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




5 


Length = menuEntry.length+1 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 12 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




6 


Length < 

MenuEntry = "ToolkitTest" 
Offset = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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Length = -1 






7 


Offset + length > menuEntry.length 

MenuEntry = "ToolkitTest " 
Offset = 11 
Length = 1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




8 


MenuEntry.length > size allocated at loading 
for each menu entry 

MenuEntry = "ToolkitTest impossible" 
Offset = 
Length = 16 


ALLOWEDLENGTHEXCEEDED 
ToolkitException is thrown. 




9 


Successful call, 
menuEntry is the whole buffer 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 1" 
Offset = 
Lengtn — 14 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SE LECTION) 


1 - No exception shall be thrown, 
Shall return ID '01'. 

2- Shall return true. 




10 


Successful call, 
menuEntry part of a buffer 

1- initMenuEntry ( ) 

MenuEntry = " 12345 67TOOLKIT TEST 2" 

Offset = 7 

Length = 14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 

2- 

isEventSet ( E VENT_MENU_SE LE CT I ON_HE LP_R 
EQUEST) 


1 - No exception shall be 
thrown, Shall return ID '02'. 
2- Shall return false. 




11 


Successful call, 
menuEntry with help supported 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 3" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = true 
IconQualif ier = '00' 
Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown, 
Shall return ID '03' 
2- Shall return true. 




12 


Successful call, 
menuEntry with an Icon 

MenuEntry = "TOOLKIT TEST 4" 
nf fqpt — n 

Length = 14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '01' [icon not self 

explanatory] 

Iconldentif ier = 1 


1 - No exception shall be thrown. 
2- Shall return ID '04' 




13 


Successful call, 


1 - No exception shall be thrown. 
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menuEntry with a next action indication 

MenuEntry = "TOOLKIT TEST 5" 
Offset = 
Length = 14 

NextAction = '24' [Select Item] 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


2- Shall return ID '05' 




14 


Successful call, 
length = 

initMenuEntry ( ) 

MenuEntry = "ToolkitTest " 
Offset = 
Length = 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No exception shall be thrown, Shall 
return ID '06'. 




15 


Initialize more entry than allocated at loading 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 11 


REGISTRYERROR 
ToolkitException is thrown. 




16 


Dynamic update of the menu stored by the me 

Fetch 




Card shall Send a 
SetUpMenu Proactive 
command: 

[CommandQualifier]=help 
supported 

[Alphald]="TOOLKIT TEST" 
[ltemld=1] = "TOOLKIT 
TEST 1 " 

[ltemld=2] = "TOOLKIT 
TEST 2" 

[ltemld=3] = "TOOLKIT 
TEST 3" 

[ltemld=4] = "TOOLKIT 
TEbT 4 

[ltemld=5] = "TOOLKIT 
TEST 5" 
[ltemld=6] = "" 
[ltemsNextAction]=0600000 
0002400 


17 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = ' 01 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '01' 




18 


Check Applet is triggered by 
ENVELOPE(MENILSELECTION) command 

Menu Entry ID = ' 02 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '02' 




19 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '03' 




20 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = ' 04 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '04' 




21 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '05' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '05' 
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22 


Check Applet is triggered by ENVELOPE 

/i\/ir~ Nil i o I — I r^TiAM I 1 1 — i r— , nrAi iron 

(MENU_SELEGTION_HELP_REQUEST) 
command 

Menu Entry ID = ' 03 ' 


Applet is trigged by an 
ENVELOPE(MENU SELECTION 
HELP REQUEST) command & 
Menu Entry ID = '03' 




23 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '06' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '06' 





6.2.9.8.4 Test Coverage 



CRR number 


Test case number 


N1 


16 


N2 


9 


N3 


11 


N4 


22 


N5 


11,16 


N6 


10 


N7 


12,16 


N8 


12,16 


N9 


13,16 


N10 


9,10,11,12,13,14,17,18,19,20,2 




1,23 


P1 


1 


P2 


2,3,4 


P3 


5,6 


P4 


7 


C1 


8 


C2 


14 



6.2.9.9 Method isEventSet 

Test Area Reference: API_2_TKR_IEVSB 
6.2.9.9.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public boolean isEventSet (byte event) 

Normal execution 

CRRN1: shall return true if the event is set in the Toolkit Registry for the applet 
CRRN2: shall return false if the event isn't set in the Toolkit Registry for the applet 
Parameters error 
No requirements. 

Context errors 

No requirements 
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6.2.9.9.2 

Test Script: 
Test Applet: 



Test suite files 
API_2_TKR_IEVSB_1 .scr 
API_2_TKR_ IEVSB _l.java 



Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 1 

- Position / Identifier for each menu entry: '0 1 70 1 ' 
Maximum number of timers: 1 

Load Script: API_2_TKR_ IEVSB_1 .ldr 

Cleanup script: API_2_TKR_ IEVSB_1 .clr 



6.2.9.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Events aren't set 

Applet calls isEventSetO for each events 
ranging from 1 to 127 excepted 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_MENU_SELECTION . 


Shall return false each time. 




2 


For EVENT_FORMATTED_SMS_PP_ENV 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


Shall return true. 




3 


For EVENT MENU_SELECTION 

isEventSet (EVENT_MENU_SE LECTION) 


Shall return true 

K-J 1 1 II 1 OLUI II L 1 LJ \j 




4 


After clearing 
EVENT FORMATTED_SMS_PP_ENV 

1- clearEvent (EVENT_FORMATTED_SMS_PP_ENV) 

2- 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Setting events 

1- For each SUPPORTED and ALLOWED events 
for setEventO, applet calls: 

1.1- setEventO method 

1.2- isEventSet () method. 


1.1- No exception shall be 
thrown. 

1 .2- Shall return true each time. 




6 


For 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- isEventSet 

(EVENT_MENU_SELECTION_HELP_REQUEST) 

2- call changeMenuEntry with help 
supported 

3- isEventSet 

(EVENT_MENU_SELECTION_HELP_REQUEST) 


1- Shall return false. 
3- Shall return true 




7 


For EVENT TIMER EXPIRATION 

1- isEventSet (EVENT_TIMER_EXP I RAT I ON) 


1- Shall return false. 
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2- call allocateTimer ( ) 

3- isEventSet (EVENT_TIMER_EXP I RAT I ON) 


3- Shall return true 




8 


For EVENT_STATUS_COMMAND 

1- isEventSet (EVENT_STATUS_COMMAND) 

2- call 

requestPoll Interval (POLL_SYSTEM_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND ) 


1- Shall return false. 
3- Shall return true 





6.2.9.9.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6,7,8 


N2 


1,5,6,7,8 



6.2.9.10 Method releaseTimer 

Test Area Reference: API_2_TKR_RTIMB 

6.2.9.10.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void releaseTimer (byte timerldentif ier ) 
throws ToolkitException 

Normal execution 

CRRN1: if it was the last allocated timer for the applet then a following call to isEventSet() method for 
EVENT_TIMER_EXPIRATION should return false. 

CRRN2: if applet has timers allocated then a call to isEventSet(EVENT_TIMER_EXPIRATION) shall return true. 

CRRN3: After invocation of the method the indicated timer shall be released and available for reallocation. 

CRRN4: The applet is deregistered of the EVENT_TIMER_EXPIRATION for the indicated Timer Identifier. 

Parameters error 

CRRP1: shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer identifier isn't between 1 
and 8. 

Context errors 

CRRC1: shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer is valid but isn't allocated to 
this applet. 

6.2.9.10.2 Test suite files 

Test Script: API_2_TKR_RTIMB_l.scr 
Test Applet: API_2_TKR_RTIMB_l.java 
Installation parameter: 

As Default, except max timer which is set to 8. 
Load Script: API_2_TKR_RTIMB_l.ldr 
Cleanup script: API_2_TKR_RTIMB_l.clr 
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6.2.9.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Releasing not allocated timers 

For each timer ID ranging from '00' to 
'FF', applet calls releaseTimer ( ID ) . 


Each time, method shall throw a 
ToolkitException with reason code 
INVALIDTIMERID. 




2 


Releasing allocated timers 

1- 8 * allocateTimer ( ) . 

2- 7 * releaseTimer (id) . 

3- isEventSet ( EVENT_T IMER_EXP IRAT ION ) 


1 - No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 




3 


Releasing invalid timer ID 

1— releaseTimer {' FF ' ) method 

2- isEventSet (EVENT_TIMER_EXPIRATION) 


1 - Shall throw a ToolkitException 
with INVALID TIMER ID reason 
code. 

2- Shall return true. 




4 


Releasing last timer 

1- releaseTimer ( last timer allocated) 

2- isEventSet ( EVENT_T IMER_EXP IRAT ION ) 


1 - No exception shall be thrown. 
2- Shall return false. 







PhaAkinn ma 4lln<^4ta limarp qftar than 

onecKing we can allocate timers atier tney 

have been released 
8 * allocateTimer () . 


No exception shall be thrown. 




6 


Releasing all timers. 

For 1 to 8, releaseTimer ( id) . 


No exception shall be thrown. 




7 


Checking applet isn't triggered by 

ENVELOPE (TIMER_EXP IRAT ION) command 
Send ENVELOPE (TIMER_EXPIRATION) 


Applet is not trigged by an 

ENVELOPE(TIMER_EXPIRATION) 

command 





6.2.9.10.4 Test Coverage 



CRR number 


Test case number 


N1 


4 


N2 


2,3 


N3 


5,6 


N4 


7 


P1 


1,3 


C1 


Framework 



6.2.9.11 Method requestPolllnterval 

Test Area Reference: API_2_TKR_RPOLS 

6.2.9.1 1 .1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void requestPolllnterval (short duration) 
throws ToolkitException 
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Normal execution 

CRRN1: If duration is between 1 and 15300 or equal to POLL_SYSTEM_DURATION, the applet registers to 
EVENT_STATUS_COMMAND. 

CRRN2: If duration is POLL_NO_DURATION, the applet is deregistered from EVENT_STATUS_COMMAND. 

Parameters error 

CRRP1: the method should throw a ToolkitException with REGISTRY_ERROR reason if duration is > 15300 or is 
< -1 (POLL_S Y S TEM_D UR ATION) . 



Context errors 

No Requirements. 

6.2.9.11.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.11.3 



Test suite files 
API_2_TKR_RPOLS_l .scr 
API_2_TKR_RPOLS_l .java 
API_2_TKR_RPOLS_l .ldr 
API_2_TKR_RPOLS_l .clr 

Test procedure 



Id 

1 



Description 



API Expectation 



APDU Expectation 



Requesting a value between 1 and 15300 s 

1- isEventSet (EVENT_STATUS_COMMMAND ) 

2- For duration ranging from 1 to 15300, 
requestPolilnterval (duration) . 

3- isEventSet (EVENT_STATUS_COMMAND) . 



1- Shall return false. 

2- No exception shall be thrown. 

3- Shall return true. 



1- Check Applet is triggered by a STATUS 
commandreset and card initialisation 

2- Send STATUS command 



2- Applet is trigged by a STATUS 
command 



Requesting POLL SYSTEM DURATION 

1- isEventSet (EVENT_STATUS_COMMMAND ) . 



2- 



ON) 



RequestPolilnterval (POLL_SYSTEM_DURATI 



1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return true. 



3- IsEventSet (EVENT_STATUS_COMMAND ) . 



Check Applet is triggered by a STATUS 
command 

1- reset and card initialisation 

2- Send STATUS command 



2- Applet is trigged by a STATUS 
command 



Requesting invalid duration 

For duration ranging from 15301 to 15305, 
-2 requestPolilnterval (duration) 



Each time, a ToolkitException with 
REGISTRY ERROR reason code, 
shall be thrown. 



Requesting POLL NO DURATION 

1- isEventSet (EVENT_STATUS_COMMMAND ) 

2- requestPolilnterval (POLL_NO_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND ) 



1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return false. 
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7 


Check Applet isn't triggered by an STATUS 
command. 

1- reset and card initialisation 

2- Send STATUS command 


2- Applet is not trigged by a 
STATUS command 





6.2.9.11.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


6,7 


P1 


5 



6.2.9.12 Method setEvent 

Test Area Reference: API_2_TKR_SEVTB 

6.2.9.12.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public void setEvent (byte id) 

throws ToolkitException 

Normal execution 

CRRN1: a following call to isEventSet() method with the same event id shall answer true for the applet. 

CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of the set event happens. 

CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_STATUS_COMMAND 

Parameters error 

CRRP1: shall throw a ToolkitException with EVENT_NOT 

CRRP2: shall throw a ToolkitException with EVENT_NOT 
EVENT_MENU_SELECTION. 

CRRP3: shall throw a ToolkitException with EVENT_NOT 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP4: shall throw a ToolkitException with EVENT_NOT 
EVENT_TIMER_EXPIRATION. 

CRRP5: shall throw a ToolkitException with EVENT_NOT 
EVENT_STATUS_COMMAND. 

Context errors 

CRRC1: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 

CRRC2: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM but another applet is already registered to it. 

6.2.9.12.2 Test suite files 

Test Script: API_2_TKR_SEVTB_l.scr 



SUPPORTED reason if event is 0. 
ALLOWED reason if event is 

ALLOWED reason if event is 

ALLOWED reason if event is 

ALLOWED reason if event is 
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Test Applet: 

Load Script: 

Cleanup script: 
6.2.9.12.3 



API_2_TKR_SEVTB_1 Java 
API_2_TKR_SEVTB_2.j ava 
API_2_TKR_SEVTB_1 .ldr 
The load script installs the 2 instances. 
API_2_TKR_SEVTB_1 .clr 

Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



1 



Applet 1 is triggered by ENVELOPE(SMS_ 
PP FORMATTED) command. 

Send ENVELOPE (SMS_PP_FORMATTED) 



Applet 1 shall be triggered 



Setting ALLOWED and SUPPORTED events 

1- For all events defined in GSM 0319 
{from 1 to 19) and allowed: 
EVENT_PROF I LE_DOWNLOAD , 
EVENT_FORMATTED_SMS_PP_ENV, 
EVENT_FORMATTED_SMS_PP_UPD, 
EVENT_UNFORMATTED_SMS_PP_ENV, 
EVENT_UNFORMATTED_SMS_PP_UPD, 
EVENT_UNFORMATTED_SMS_CB, 
EVENT_CALL_CONTROL_BY_SIM, 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 
EVENT_EVENT_DOWNLOAD_MT_CALL, 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 
EVENT_EVENT_DOWNLOAD_CALL_D I SCONNECTED , 
EVENT_EVENT_DOWNLOAD„LOCATION_STATUS, 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABL 
E, 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

1.1- clearEvent (event ) 

1.2- isEventSet (event ) 

1.3- setEvent (event ) 

1.4- isEventSet (event ) 

1.5- clearEvent (event ) 



1.1- No exception shall be thrown. 

1.2- Shall return false. 

1 .3- No exception shall be thrown. 

1 .4- Shall return true. 

1 .5- No exception shall be thrown. 



Event 



Call setEvent (0) 



Shall throw a ToolkitException with 
EVENTNOTSUPPORTED reason 
code. 



Setting EVENT_MENU_SELECTION 

Call setEvent (EVENT_MENU_SE LECTION) 



Shall throw a ToolkitException with 
EVENTNOTALLOWED reason 
code. 



Setting 

EVENT_MENU_SELECTION_HELP_REQUEST 

Call 

setEvent (EVENT_MENU_SELECTION_HELP_REQUES 
T) 



Shall throw a ToolkitException with 
EVENT NOT ALLOWED reason 
code. 



Setting EVENT TIMER EXPIRATION 

Call setEvent (EVENT_TIMER_EXPIRATION) 



Shall throw a ToolkitException with 
EVENT NOT ALLOWED reason 
code. 



Setting EVENT_STATUS_COMMAND 



Shall throw a ToolkitException with 
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Call setEvent (EVENT_STATUS_COMMAND) 


EVENTNOTALLOWED reason 
code. 




8 


Setting EVENT_CALL_CONTROL_BY SIM 

Call setEvent (EVENT_CALL_CONTROL_BY_SIM) 


No Exception shall be thrown 




9 


Setting 

EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM 

Call 

s et Event ( EVENT_MO_SHORT_ME S SAGE_CONTROL_B 
Y_SIM) 


No Exception shall be thrown 




1 U 


Lrii6CK appiei is inygereu uy an 
ENVELOPE(CALLCONTROLBYSIM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE(CALL CONTROL BY 
SIM) 




1 1 


Check applet is triggered by an 
ENVELOPE(MO SHORT MESSAGE CONTRO 
L_BY_SIM) 

Trigger the Applet 


Applet is trigged by an 
ENVELOPE(MO SHORT MESSAG 
E_CONTROL_BY_SIM) 




12 


Applet 2 is triggered by ENVELOPE(SMS 
PP_DOWNLOAD) command. 

Trigger the applet 2 


Applet 2 is trigged by an 
ENVELOPE(SMS_ 
PP_DOWNLOAD) command 




13 


Applet 2 registers to 
CALL CONTROL BY SIM 
but it is already assigned 

setEvent (EVENT_CALL_CONTROL_BY_SIM) 


Shall throw a ToolkitException with 
EVENTALREADYREGISTERED 
reason code. 




14 


Applet 2 registers to 
MO_MESSAGE_CONTROL_BY SIM 
but it is already assigned 

s et Event ( EVENT_MO_SHORT_ME S SAGE_CONTROL_B 
Y_SIM) 


Shall throw a ToolkitException with 
EVENTALREADYREGISTERED 
reason code. 





6.2.9.12.4 Test Coverage 



CRR number 


Test case number 


N1 


2 


N2 


1, 8,9,10, 11,12 


N3 


2,4,5,6,7 


P1 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


C1 


13 


C2 


14 



6.2.9.13 Method setEventList 

Test Area Reference: API_2_TKR_SEVL_BSS 
6.2.9.13.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public void setEventList (byte [ ] eventList, 

short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsExcept ion, 
ToolkitException 
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Normal execution 

CRRN1: for all events set successfully by this method, a call to isEventSet() method should return true. 

CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of one of the successfully registered 
events happens. 

CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_ST ATUS_COMM AND . 

Parameters error 

CRRP1: shall throw a java.lang.NullPointerException if eventList is null. 

CRRP2: shall throw a java.lang.ArraylndexOutOfBoundsException if offset would cause access outside array 
bounds. 

CRRP3: shall throw a java.lang.ArraylndexOutOfBoundsException if length would cause access outside array 
bounds. 

CRRP4: shall throw a java.lang.ArraylndexOutOfBoundsException if both offset and length would cause access 
outside array bounds. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_S UPPORTED reason if event is 0. 

CRRP6: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
E VENT_MEN U_S ELECTION . 

CRRP7: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_TIMER_EXPIRATION. 

CRRP9: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_STATUS_COMMAND. 

Context errors 

CRRC1: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 

CRRC2: shall throw a ToolkitException with E VENT_ ALRE AD Y_REGIS TERED if eventList contains 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM but another applet is already registered to it. 



6.2.9.13.2 

Test Script: 
Test Applet: 

Load Script: 

Cleanup script: 
6.2.9.13.3 



Test suite files 

API_2_TKR_SEVL_BSS_1 .scr 
API_2_TKR_ SEVL_BSS _l.java 
API_2_TKR_ SEVL_BSS _2.java 
API_2_TKR_ SEVL_BSS_l.ldr 
The load script installs the 2 instances. 
API_2_TKR_ SEVL_BSS_l.clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet 1 Registering all eventList buffer 

EventList = all allowed events defined in 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 
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GSM 0319: 

EVENT_PROF I LE_DOWNLOAD , 

EVENT_FORMATTED_SMS_PP_ENV, 

EVENT_FORMATTED_SMS_PP_UPD, 

EVENT_UNFORMATTED_SMS_PP_ENV, 

EVENT_UNFORMATTED_SMS_PP_UPD, 

EVENT_UNFORMATTED_SMS_CB, 

EVENT„CALL„CONTROL„BY„SIM, 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 

EVENT_EVENT_DOWNLOAD_MT_CALL , 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 

EVENT_EVENT_DOWNLOAD_CALL_D IS CONNECTED, 

EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS , 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

, EVENT_EVENT_DOWNLOAD_CARD„READER_S TATUS 

1- For each event in EventList 
clearEvent (event) 



3- Each time shall return true. 

4- No exception shall be thrown. 



2- setEventList (eventList) 
Offset = 

Length = eventList . lentgh 

3- For all events in eventList 
isEventSet (event) 

4- For each event in EventList 
clearEvent (event) 



Registering part of eventList buffer 

EventList = all allowed events defined in 
GSM 0319 (see test case 1) . 



1- For each event in EventList 
clearEvent (event) 

2- setEventList (eventList, offset, 
length) 

Offset > 

Length = eventList . lentgh - offset 

3- For all events in eventList: 
isEventSet (event) 



1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Each time shall return true for 
events ranging from offset to 
offset+length else shall return false 

4- No exception shall be thrown. 



4- For each event in EventList: 
clearEvent (event) 



Null buffer 



EventList = null 



Shall throw a 

java.lang.NullPointerException 
Exception 



Out of bounds offset 

Offset = eventList . length 
Length = 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 



Out of bounds and big offset 



Offset = 255 
Length = 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 



Offset < 



Offset = -1 
Length = 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 



Out of bounds length 

Offset = 

Length = eventList . length + 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 
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8 


Out of bounds and big length 

Offset = 
Length = 255 


Shall throw a 

java.lang. Array I ndexOutOf Bounds 
Exception 




9 


Length < 

Offset = 
Length = -1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 




10 


Out of bounds offset + Length 

Offset + length > eventList . length + 1 


Shall throw a 

lann ArrPvlnHpYOutOfRoiinH^ 

J d v d . I cli iy . r^i [ ay 1 1 iuc a^*u i_ *uu I 1 vjo 

Exception 




11 


Event 

Call setEventList (eventList) with 

;__.i7-;__.n~r~T,~ic~r~ i nH i paf i nrr ouont" 

CvcllUlilOU -LI 1 \_1-L L-dU-Lllvj CVC11U \J 


Shall throw a ToolkitException with 
EVENTNOTSUPPORTED 
reason code. 




12 


EVENT_MENU_SELECTION 

Call setEventList (eventList) with 
eventList indicating EVENT MENU SELECTION 


Shall throw a ToolkitException with 
reason code 

EVENTNOTALLOWED. 




13 


EVENT MENU_SELECTION_HELP_REQUEST 

Call setEventList (eventList) with 

C Veil LlilD L _LJ.HJ--Ll_.Cil Lily 

EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
reason code 

EVENTNOTALLOWED. 




14 


EVENT_TIMER_EXPI RATION 

Call setEventList (eventList) with 

£_.T7i__.n"l _ T,"i c:+* "i nH i paf -i r~u~t 

C V CllLLl o L -LI 1 V-l-L a. t_- _L 1 1 \J 

EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException with 
reason code 

EVENTNOTALLOWED. 




15 


EVENT_STATUS_COMMAND 

Call setEventList (eventList) with 
eventList indicating EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 
reason code 

EVENTNOTALLOWED. 




16 


Setting EVENT_CALL_CONTROL_BY_SIM 

OCLEj Veil UJJl O L \lll_)L^ W ^ ^/ W-LL-ll __J_LoU 

containing 

EVENT_CALL_CONTROL_BY_SIM S 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 


Shall not throw an exception 




17 


Check applet is triggered by an 
ENVELOPE(CALL_CONTROL_BY_SIM) 

Reset and initialise the card 
Trigger the applet 


Mppitii lb iriyytiu uy d.n 
ENVELOPE(CALL CONTROL BY 
_SIM) 




18 


Check applet is triggered by an 
ENVELOPE(MO SHORT MESSAGE CONTROL 
_BY_SIM) 

Trigger the applet 


Applet is trigged by an 

ENVELOPE(MO_SHORT_MESSA 

GECONTROLBYSIM) 




19 


Applet 2 registers to CALL_CONTROL_BY_SIM 
but it is already assigned 

setEventList (MonoEventList, 0, 1) with 
MonoEventList containing 
EVENT_CALL_CONTROL_BY_SIM 


Shall throw a ToolkitException with 
EVENTALREADYREGISTERED 
reason code. 




20 


Applet 2 registers to 
MO_SHORT_MESSAGE_CONTROL BY SIM 
but it is already assigned 
set EventList(MonoEventList,0,1 ) with 
MonoEventList containing 
EVENT MO SHORT MESSAGE CONTROL BY 
_SIM 


Shall throw a ToolkitException with 
EVENTALREADYREGISTERED 
reason code. 
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CRR numhpr 

VI II 1 1 IUIIIUCI 


Tp^t raqp numhpr 

1 CO l ouoC IIUIIIUCI 


N1 

IN I 


1 9 


N9 


1 fi 17 1 8 


I NO 


1911 19 1^14 1^ 

1 .C-, II, 1 1 O, 1 t, 1 O 


P1 


o 


P2 


4 5 fi 


P3 


7,8,9 


P4 


10 


P5 


11 


P6 


12 


P7 


13 


P8 


14 


P9 


15 


C1 


19 


C2 


20 



6.2.10 Class ViewHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EditHandler, EnvelopeHandler, ProactiveResponseHandler, ProactiveHandler. 

6.2.1 1 Class ToolkitException 

6.2.1 1 .1 Exception Constants 

Test Area Reference: API_2_TKE_CONS 

6.2.1 1 .1 .1 Conformance requirement: 

There is no API, only constants. 

Normal execution 

CRRN1: The Constants of the class ToolkitException shall all have the same name and value defined in the 
GSM03.19 . 

Parameters error 

No requirements 

Context errors 

No requirements 

6.2.11.1.2 Test suite files 

None 

6.2.11.1.3 Test procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.1 1 .2 Constructor ToolkitException 

Test Area Reference: API_2_TKE_COORS 
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6.2.1 1 .2.1 Conformance requirement: 

The constructor with following headershall compliant to its definition in the API. 

public ToolkitException {short reason) 

Normal execution 

CRRN1: Construct a ToolkitException instance with the specified reason. 

Parameters error 

No requirements 

Context errors 

No requirements 

6.2.11.2.2 Test suite files 

No additional requirements for the GSM personalisation: 
Test Script: API_2_TKE _COORS_l .scr 

Test Applet: API_2_TKE _COORS_l java 

Load Script: API_2_TKE _COORS_l .ldr 

Cleanup script: API_2_TKE _COORS_l .clr 



6.2.11.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reason = (short) 19 


ToolkitException.getReason() = 
(short) 19 





6.2.11.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1 



6.2.11.3 Method throwlt 

Test Area Reference: API_2_TKE_THITS 

6.2.1 1 .3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static void throwlt (short reason) 
throws ToolkitException 

Normal execution 

CRRN1: Throws the JCRE instance of the ToolkitException class with the specified reason. 
CRRN2: extends javacard.framework.CardRuntimeException 

Parameters error 

No requirements 
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Context errors 

No requirements 

6.2.11.3.2 Test suite files 

No additional requirements for the GSM personalisation: 

Test Script: API_2_TKE_ THITS_1 .scr 

Test Applet: API_2_TKE_ THITS_1 .java 

Load Script: API_2_TKE_ THITS_1 .ldr 

Cleanup Script: API_2_TKE_THITS_l.clr 



6.2.11.3.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 15 




4 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 15 





6.2.11.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


4, 5, 6 



6.3 SIM Toolkit Framework 
6.3.1 Minimum Handler Availability 

This test area tests the rules that define the minimum requirements for the availability of the system handlers. 

6.3.1.1 ProactiveHandler 

Test Area Reference: FWK_MHA_ PAHD 



6.3.1.1.1 

Normal Execution 



Conformance Requirement 



CRRNl: If a proactive session is not ongoing the ProactiveHandler is available from the invocation to the 
termination of the processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_CB 
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EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFILE_DOWNLOAD 



6.3.1.1.2 



Test Suite Files 



Test Script: 



FWK_MHA_ PAHD_1 .scr 



Test Applet: 



FWK_MHA_ PAHD_l.java 



FWK_MHA_PAHD_2.java 



Load Script: 



FWK_MHA_ PAHD_l.ldr 



Cleanup Script: 



FWK_MHA_ PAHD_1 .clr 



Parameter File: 



FWK_MHA_ PAHD_l.par 
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6.3.1.1.3 Test Procedure 



Id 


Description 


API /Framework Expectation 


APDU Expectation 


1 


Applets registration to all events and Proactive 
Handler availability with 
EVENT_PROFILE_DOWNLOAD 

Appletl is registered to all events 
defined in [ 7 ] . 

Using the methods initMenuEntry () for 

EVENT_MENU_SE LECTION, requestPoll Interval 
() for EVENT_STATUS_COMMAND, allocateTimer 
() for EVENT_TIMER_EXPIRATION and 

setEventList () for the rest of the 

events . 

Applet2 is registered to all events 

defined in [7], except 

EVENT_CALL_CONTROL_BY_SIM and 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 

Using the methods initMenuEntry () for 

EVENT_MENU_SE LECTION, requestPoll Interval 
() for EVENT_STATUS_COMMAND, allocateTimer 
() for EVENT_TIMER_EXP IRATION and 

setEventList () for the rest of the 

events . 

The priority of appletl is higher than 
priority of applet2 

1- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST, 
POLL_INTERVAL, SET UP IDLE MODE TEXT and 
SET UP MENU. 

2- Appletl gets the Proactive Handler 
Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 

3- Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT_PROFILE_DOWNLOAD 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




2 


Proactive Handler availability with 
EVENT J\1ENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Envelope menu selection with help 
request is sent to the SIM 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- Applet2 is triggered 

4- No exception is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


3 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
SIM 

2- Appletl gets the Proactive Handler 

3- Envelope menu selection is sent to the 
SIM 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




4 


Proactive Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad formatted is sent 
to the SIM 

2- Appletl gets the Proactive Handler 

3- Envelope dataDownLoad formatted is sent 
to the SIM 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




5 


Proactive Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad unformatted is 
sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




6 


Proactive Handler availability with 
EVENT_UNFORMATTED_CELL BROADCAST 

1- Envelope cell broadcast unformatted is 
sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- Applet2 is triggered 

4- No exception is thrown 




7 


Proactive Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
SIM 

2- Appletl gets the Proactive Handler 

3- Timer id=2 

Envelope Timer Expiration is sent to the 
SIM 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




8 


Proactive Handler availability with 
EVENTCALLCONTROLBYSIM 







ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



260 



ETSI TS 101 955 V8.0.0 (2002-09) 



Id 


Description 


API /Framework Expectation 


APDU Expectation 




1- Envelope call control by SIM is sent to 
the SIM 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 




q 


Prnni^ti vo MsanHlor* sawailaHilitw uirith 
nucii/Uvc ncniuici dvaiiduiiiiy wiiii 

EVENT_MO_SHORT_MESSAGE_CONTROL 

1- Envelope mo short message control by SIM 
is sent to the SIM 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 




10 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




11 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




12 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




13 


Applets triggering with 
EVENT_EVENT_LOCATION_STATUS 

1- Envelope event download location status 
is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




14 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

l-Envelope event download user activity is 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 




sent to SIM 


1- Appletl is triggered 






2-Appletl gets the Proactive Handler 


2- No exception is thrown 

3- Applet2 is triggered 






3-Applet2 gets the Proactive Handler 


4- No exception is thrown 




15 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




16 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




17 


Proactive Handler availability with 
EVENT ST ATUS_COMMAND 

1- Status command is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




18 


Proactive Handler availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 





6.3.1.1.4 Test Coverage 

T CRR Number ! Test Case Number 
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CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7,8,9,10,11,12, 
13,14,15,16,17,18 



6.3.1.2 ProactiveResponseHandler 

Test Area Reference: FWK_MHA_ PRHD 

6.3.1.2.1 Conformance Requirement 
Normal Execution 

CRRN1: The ProactiveResponseHandler is available after the first call to the ProactiveHandler.send method to the 
termination of the processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFILE_DOWNLOAD 

6.3.1.2.2 Test Suite Files 



Test Script: FWK_MHA_ PRHD_1 .scr 

Test Applet: FWK_MHA_ PRHD_1 .java 

FWK_MHA_PRHD_2.j ava 
Load Script: FWK_MHA_ PRHD_1 .ldr 

Cleanup Script: FWK_MHA_ PRHD_1 .clr 
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Parameter File : FWK_MHA_ PRHD_ 1 .par 



6.3.1 .2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to all events and Proactive 
Response Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Appletl is registered to all events 
defined in [7], applet2 is registered to 
all events defined in [7] except 

TT\7TTMT HAT T rnUTDHT TAV QTM = n H 

£j v i i^rtijij i^uin i r\Uij d i o in anci 

EVENT_MO_SMS_CONTROL_B Y_S IM . 
Using the methods initMenuEntry ( ) for 
EVENT_MENU_SE LECTION, 
requestPollInterval ( ) for 

E VENT_S TATU S_COMMAND , a 1 1 o c at e T ime r ( ) for 
EVENT_TIMER_EXP IRATION and setEventList ( ) 
for the rest of the events. 

1-Terminal Profile command is sent to the 
SIM without the facility of SET_EVENT_LIST 
and POLL_INTERVAL, , SET UP IDLE MODE TEXT 

anQ Oil Ur l v lrjlNU. 


1 -Appletl is triggered 
No exception is thrown 






Appletl builds a proactive command DISPLAY 
TEXT . 

2- ProactiveHandler . send ( ) method is 
called 


3- No exception is thrown 


2- The proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 








Appletl is deregistered to 
EVENT_PROF I LE_DOWNLOAD 


4- Applet2 is triggered 






Appletl execution is finished 








Applet2 builds a proactive command DISPLAY 
TEXT . 

4- ProactiveHandler . send ( ) method is 
called 


6- No exception is thrown 


5- The proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 








Appletl is deregistered to EVENT_PROFILE_DOWNLOAD 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT J\1ENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1-Envelope menu selection with help 
request is sent to the SIM 



Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is 
called 



3- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 

Appletl execution is finished 

Envelope menu selection with help request 

is sent to the SIM 



Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 



ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is 
called 



3 - ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

4- Envelope menu selection is sent to the 
SIM 



Applet2 builds a proactive command DISPLAY 
TEXT 

5- ProactiveHandler . send ( ) method is 
called 



6-ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT FORMATTED_SMS_PP_ENV 

l-Envelope dataDownLoad formatted is sent 
to the SIM 



Applet builds a proactive command DISPLAY 
TEXT 

2-ProactiveHandler . send ( ) method is called 



3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

4- Envelope dataDownLoad formatted is sent 
to the SIM 



Applet2 builds a proactive command DISPLAY 
TEXT 

5-ProactiveHandler . send ( ) method is called 



6-ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

l-Envelope dataDownLoad unformatted is 
sent to the SIM 



Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is 
called 



ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 



Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 



ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS _CB 

l-Envelope call broadcast unformatted is 
sent to the SIM 



Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 



3-ProactiveResponseHandler . getTheHandler ( ) 
method is called. 



Appletl execution is finished 

Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 



5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 

4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handler availability with 
EVENT_TIMER_EXPIRATION 

Timer id=l 

l-Envelope Timer Expiration is sent to the 
SIM 



Applet builds a proactive command DISPLAY 
TEXT 

2-ProactiveHandler . send ( ) method is called 



3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 
Timer id=2 

Envelope Timer Expiration is sent to the 
SIM 



Applet builds a proactive command DISPLAY 
TEXT 

4-ProactiveHandler . send ( ) method is called 



5-ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Applet2 execution is finished 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



5- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



6- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

l-Envelope call control by sim is sent to 
the SIM 



Applet builds a proactive command DISPLAY 
TEXT 

2-ProactiveHandler . send ( ) method is called 



1- Appletl is triggered 



3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 



3- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handler availability with _ 
MO_SHORT_MESSAGE_CONTROL_BY_SIM 

l-Envelope mo short message control by sim 
is sent to the SIM 



Applet builds a proactive command DISPLAY 
TEXT 

2-ProactiveHandler . send ( ) method is called 



3-ProactiveResponseHandler.getTheHandler() method is 
called 



1- Appletl is triggered 



3- No exception is thrown 



Appletl execution is finished 



2- A proactive command 
DISPLAY TEXT is fetched 
TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


10 


Proactive Response Handler availability with 
EVENT EVENT_DOWNLOAD_MT_CALL 

l-Envelope event download mt call is sent 
to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 


1- Appletl is triggered 






2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called. 

Appletl execution is finished 


3- No exception is thrown 

4- Applet2 is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 








4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


TERMINAL RESPONSE 


11 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 


1- Appletl is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 




*-i — ~y~ r~> f ~\~ ~i T7oDocrmn Qo^^inHl nc^'h'TVkCiW^'n/Hl ot~ { \ 
O jri_UCi.L-i L Vcr\copuilocnallUlcl .yt LllcrlcLllL-lXt;-L \ / 

method is called 

Appletl execution is finished 


3- No exception is thrown 

4- Applet2 is triggered 


TERMINAL RESPONSE 




Applet builds a proactive command DISPLAY 
TEXT 








4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


12 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 


1- Appletl is triggered 

3- No exception is thrown 

4- Applet2 is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 


13 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download location status 
is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 


1 - Appletl is triggered 

3- No exception is thrown 

4- Applet2 is triggered 


2-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 

5- A proactive command 
DISPLAY TEXT is fetched 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 4 

1 H 


Prnartiuo Rocnnnco HanHlar ax/ailaKilitw \A/ith 
r i uaLLi vc ncouui loc nciiiuit?! d vdiidk/ii i ly wiiii 








EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 








l-Envelope event download user activity is 


1- Appletl is triggered 






sent to the SIM 








Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 












2-A proactive command 








DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 


3- No exception is thrown 


TERMINAL RESPONSE 




msthod is csllsd 






Appletl execution is finished 










4- Annlpt? trinnprpd 






Applet2 builds a proactive command DISPLAY 








TEXT 








4- ProactiveHandler . send ( ) method is 




5- A proactive command 




called 




niCPI AV TPYT ic fotchorl 

uiorLMY 1 1 a i is Teicneo 








TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 


6- No exception is thrown 






method is called 




15 


Proactive Response Handler availability with 








EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_ 








A W A II ADI C 

AVAILAbLL 








l-Envelope event download idle screen 


1 - Appletl is triggered 






available is sent to the SIM 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A nrnantivp command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 


3- No exception is thrown 






method is called 








Appletl execution is finished 










4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 












5- A proactive command 




4- ProactiveHandler . send ( ) method is 




DISPLAY TEXT is fetched 




called 












TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 


6- No exception is thrown 






method is called 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Proactive Response Handler availability with 








EVENT EVENT DOWNLOAD CALL CONNECT 

L. V L_ 1 1 1 L V LI1 1 U\J Wall ^\Jr^U \^r^^^ \-/ \^ 1 111 ^ ^/ 1 








ED 








l-Envelope event download card reader 


1 - Appletl is triggered 






status is sent to the SIM 








Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 












2-A proactive command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 


3- No exception is thrown 






method is called 








Appletl execution is finished 










4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 












5- A proactive command 




4 — P r oact i veHandle r . s end ( ) method is 




DlbrLAY I tx I is fetched 




called 












TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 


6- No exception is thrown 






method is called 




■|7 


Prnartivp Rp^nnrmp Hanrilpr availahilitv with 

r I ua\/ii vc iicomviioc I lai iuici avcuiciuiiiiy vv 1 11 1 








EVENT_STATUS_COMMAND 








l-Status command is sent to the SIM 


1 - Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 


3- No exception is thrown 






method is Called 








Appletl execution is finished 










4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 












5- A proactive command 




4- ProactiveHandler . send { ) method is 




DISPLAY TEXT is fetched 




called 












TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 


6- No exception is thrown 






method is called 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


18 


Proactive Response Handler availability with 
















1-An unrecognized Envelope is sent to the 


1- Appletl is triggered 






SIM 








Appletl builds a proactive command DISPLAY 








TEXT 












2- A proactive command 




2-ProactiveHandler . send ( ) method is called 




DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 








method is called 


3- No exception is thrown 






Appletl execution is finished 










4- Applet2 is triggered 






flr~ir"i"ii^^'? hni 1 He 3 nrAaff i irfi i"^mm a n H n T T 2\ V 




5- A proactive command 




TEXT 




DISPLAY TEXT is fetched 




4- ProactiveHandler . send { ) method is 




~ri — nn aim a i ni — o n ioi — 

TERMINAL RESPONSE 




called 










6- No exception is thrown 






5- 

ProactiveResponseHandler . getTheHandler ( ) 








method is called 







6.3.1.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7,8,9,10,11,12,13, 
14,15,16,17,18 



6.3.1.3 EnvelopeHandler 

Test Area Reference: FWK_MHA_ ENHD 
6.3.1.3.1 Conformance Requirement 

Normal Execution 

CRRN1: The EnvelopeHandler and its content are available for all toolkit applets triggered from the invocation to 
the termination of their processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 
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EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

Context Errors 

CRRC1: The EnvelopeHandler and its content are not available for any toolkit applet triggered from the invocation 
to the termination of their processToolkit method for the following events: 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

6.3.1.3.2 Test Suite Files 



Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



FWK_MHA_ ENHD_1 .scr 
FWK_MHA_ ENHD_l.java 
FWK_MHA_ENHD_2.j ava 
FWK_MHA_ ENHD_1 .ldr 
FWK_MHA_ ENHD_1 xlr 
FWK_MHA_ ENHD_1 .par 
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6.3.1 .3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Appletl and Applet2 registration and Envelope 
Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Appletl is registered to all events 
defined [ 7 ] . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SE LECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXP IRATION and setEventList ( ) 
for the rest of the events. 

Applet2 is registered to all events 
defined [7] except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT__MO„SHORT_MESSAGE_CONTROL_BY_SIM. 
Using the methods initMenuEntry ( ) for 
EVENT_MENU_SE LECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer for 
EVENT_TIMER_EXP IRATION and setEventList 
for the rest of the events. 

2- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 

, SETUP_IDLE_MODE_TEXT , POLL_INTERVAL and 
SETUP MENU 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 

4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 

Applet2 is deregistered to 
EVENT_PROFILE_DOWNLOAD 


1 - No exception is thrown 

2- Appletl is triggered 

3- A Toolkit exception 

HAMDI PR MOT AVAII ARI F ic 

thrown 

4- Applet2 is triggered 

5- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




2 


Envelope Handler availability with 
EVENT J\flENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

Envelope menu selection with help request 
is sent to the SIM 

Appletl is triggered 

1- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

2- Envelope menu selection with help 
request is sent to the SIM 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- No exception is thrown. 
Appletl finalizes. 

2- Applet2 is triggered 

3- No exception is thrown. 




3 


Envelope Handler availability with 
EVENT_MENU_SELECTION 

l-Envelope menu selection is sent to the 
SIM 


1- Appletl is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- Envelope menu selection is sent to the 
SIM 

4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 





ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



276 



ETSI TS 101 955 V8.0.0 (2002-09) 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Envelope Handler availability with 
EVENT FORMATTED_SMS_PP_ENV 

1- A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3 - A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




5 


Envelope Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- An unformatted sms pp envelope is sent 
to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




6 


Envelope Handler availability with 
EVENTUNFORMATTEDCB 

1- Envelope cell broadcast unformatted is 
sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

3- Applet2 is triggered 

4- No exception is thrown 




7 


Envelope Handler availability with 
EVENTTIMEREXPIRATION 

Timer id=l 

1- Envelope Timer Expiration is sent to the 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

Timer id=2 

3~Envelope Timer Expiration is sent to the 
SIM 

4-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 
Applet2 finalizes. 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




8 


Envelope Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

l-Envelope call control by sim is sent to 


1- Appletl is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




the SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 


2- No exception is thrown. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


9 


Envelope Handler availability with 
EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM 

1- Envelope mo short message control by sim 
is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet 1. 


1- Appletl is triggered 

2- No exception is throw 




10 


Envelope Handler availability with 
EVENT EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




11 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




12 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONE 
CTTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered. 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




13 


Envelope Handler availiability with 
EVENT EVENT DOWNLOAD LOCATION STA 
TUS 

1- Envelope event download location status 
is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


14 


Envelope Handler availiability with 
EVENT EVENT DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

3- Applet2 is triggered 

4- No exception is thrown 




15 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




16 


Envelope Handler availiability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




17 


Envelope Handler availaibility with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLERNOTAVAILABLE is 

U II UVVI 1 

3- Applet2 is triggered 

4- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




18 


Envelope Handler availiability with EVENT 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


4- No exception is thrown. 





6.3.1.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


14,15,16,17,18,19,20,21 


CRRN2 


14,15,16,17,18,19,20,21 


CRRC1 


1,2,3,4,5,6,7,8,9,10,11,12,13 



6.3.1.4 EnvelopeResponseHandler 

Test Area Reference: FWK_MHA_ ERHD 

6.3.1.4.1 Conformance Requirement 

Normal Execution 

CRRN1: The handler is available for all triggered toolkit applets from the invocation of the processToolkit method 
of the toolkit applet until a toolkit applet has posted an envelope response or the first invocation of the 
ProactiveHandler.send method for the following events:. 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_UNRECOGNIZED_ENVELOPE 
CRRN2: After a call to the post method the handler is not longer available 
CRRN3: After a call to the send method the handler is not longer available 

Context Errors 

CRRC1: The handler is not available for the following events: 
EVENT_UNFORMATTED_SMS_CB 
EVENT_MENU_SELECTION 
EVENT_MENU_SELECTION_HELP_REQUEST 
EVENT_TIMER_EXPIRATION 
EVENT_EVENT_DOWNLOAD_MT_CALL 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
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EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

6.3.1 .4.2 Test Suite Files 



Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 

6.3.1.4.3 



FWK_MHA_ ERHD_l.scr 
FWK_MHA_ ERHD_l.java 
FWK_MHA_ERHD_2.java 
FWK_MHA_ ERHD_l.ldr 
FWK_MHA_ ERHD_1 .clr 
FWK_MHA_ ERHD_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Toolkit Appletl and Toolkit Applet2 
registration and Envelope Response Handler 
availability with 
EVENT PROFILE DOWNLOAD 



1- Appletl Toolkit 1 is registered to all 
events defined in [7] . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SE LECTION, 
requestPollInterval ( ) for 

E VENT_S T ATU S_COMMAND , allocateTimer ( ) for 
EVENT_TIMER_EXP IRATION and setEventList ( ) 
for the rest of the events. 

Applet2 Toolkit 2 is registered to 
EVENT_UNFORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNIZED_ENVELOPE . 

2- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 

, SETUP_IDLE_MODE_TEXT, SETUP_MENU and 
POLL_INTERVAL. 

Appletl is triggered 

32-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 



1 - No exception is thrown 



2- Appletl is triggered 



3- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



282 



ETSI TS 101 955 V8.0.0 (2002-09) 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Envelope Response Handler availiability with 
EVENT J\1ENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLERNOTAVAILABLE is 
thrown 




3 


Envelope Response Handler availiability with 
EVENT_MENU_SELECTION 

1- A envelope menu selection is sent to the 
SIM 

The Appletl is triggered 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




4 


Envelope Response Handler availability with 
EVENT UNFORMATTED CB 

1- Envelope cell broadcast unformatted is 
sent co die o.li v i 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




5 


Envelope Response Handler availiability with 
EVENT_TIMER_EXPIRATION 

1- Envelope Timer Expiration is sent to the 
SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




6 


Envelope Response Handler availiability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2 -A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




7 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

l-Envelope event download call connected 
is sent to the SIM 


1- Appletl is triggered. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


2- A Toolkit exception 
HANDLERNOTAVAILABLE is 
thrown 




8 


Envelope Response Handler availiability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




9 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD LOCATION STA 
TUS 

1- Envelope event download location status 
is sent to the SIM 

2- Applet A obtains the Envelope Response 
Handler 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




10 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
senr. 10 rne oii v i 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




11 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




12 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1— Envelope event download card reader 
status is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 






thrown 




13 


Envelope Response Handler availability with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLERNOTAVAILABLE is 
thrown 




14 


Envelope Response Handler availability with 
EVENT FORMATTED_SMS_PP_ENV 

1- A formatted sms pp envelope is sent to 
the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3- Appletl builds an additional information 
for response packet and it calls the post 
method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5 - A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

6- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the send() method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


1- Appletl is triggered 

2- No exception is thrown. 

4- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 

5- Appletl is triggered 

6- No Exception is thrown 

8- Toolkit exception 

HANDLER NOT AVAILABLE is 

thrown for each method 


3- The response packet is 
sent 

7- The proactive command 
is sent 


15 


Envelope Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- A unformatted sms pp envelope is sent to 
the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3- Appletl builds the envelope response and 
it calls the post() method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5- EnvelopeResponseHandler . getTheHandler ( ) 


1- Appletl is triggered 

2- No exception is thrown. 

4- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 

5- Applet2 is triggered. 


3- The envelope response is 
sent 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




method is called 
Applet2 finalizes. 


6- A Toolkit exception 
HANDLER NOT AVAILABLE iq 

1 \f\\ N L-/ 1 1 1 I 1 >J v_y 1 I \ V 1 \ \ 1 1 \ 1 1 1 1 IO 

thrown. 






6-A unformatted sms pp envelope is sent to 
the SIM 


7- Appletl is triggered 






7-EnvelopeResponseHandler . getTheHandler ( ) 
method is called. 


8- No exception is thrown. 






8- Appletl builds a proactive command and 
it calls the send() method 

9- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


1 0- A Toolkit exception 
HANDLERNOTAVAILABLE is 
thrown for each method 

Appletl finalizes 

1 1 - Applet2 is triggered 


9- The proactive command 
is fetched and the Terminal 
response is issued. 




10-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 


1 2- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown 




16 


Envelope Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

1- Envelope call control by sim is sent to 
the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 






3- Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5- Envelope call control by sim is sent to 
the SIM 

6- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


2- No exception is thrown. 

4- Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 

5- Appletl is triggered 


3- The envelope response is 
sent 




7- Appletl builds a proactive command and 
it calls the send() method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


6- No Exception is thrown 

8- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 


7- The proactive command 
is fetched and the Terminal 
response is issued 


17 


Envelope Response Handler availability with 
EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM 

l-Envelope mo short message control by sim 
is sent to the SIM 


1- Appletl is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


2- No exception is thrown. 






3-Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) method 




3-The envelope response is 
sent 




4-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 


4- A Toolkit exception 
HANDLERNOTAVAILABLE is 
thrown for each method 






5-Envelope mo short message control by sim 
is sent to the SIM 


5- Appletl is triggered 






6- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the send method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


6- No exception is thrown 

8- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 


7- The proactive command 
is fetched and the Terminal 
Response is issued 


18 


Envelope Response Handler availability with 
EVENT_UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown. 






3- Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) or post method 

4- Appletl calls all methods of Envelope 
Response Handler (including the inherited 
method) 

The Appletl finalizes 


4- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 

5- Applet2 is triggered. 


3- The envelope response is 
sent 




54-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 

Applet2 finalizes 


6- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 






6-An unrecognized Envelope is sent to the 
SIM 


7- Appletl is triggered. 






7-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 


8- No exception is thrown. 






8- Appletl builds a proactive command and 
it calls the send() method 

9- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


I U n I UUIrxIl tJXLit;|JUUI I 

HANDLER NOT AVAILABLE is 

thrown for parh mpthnrl 

II II U VVl 1 IUI CCIL-I 1 1 1 ICLI IUU 

Appletl finalizes 

1 1 - Applet2 is triggered 


9- The proactive command 
is fetched and the Terminal 
response is issued 




10-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 






1 2- A Toolkit exception 
HANDLERNOTAVAILABLE is 
thrown for each method 




19 


The envelope response is sent when a 
proactive session is ongoing 

1- A formatted SMS PP envelope is sent to 
the SIM. 

2- Proactive command DISPLAY TEXT is built 
and it calls the send() method. 

3 - A call control by sim envelope is sent 
to the SIM. 


1- Appletl is triggered. 
3- Appletl is triggered 


2- 91 XX 




4- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

5- Appletl builds the envelope response and 
it calls the postAsBERTLV 


4- No exception is thrown 


5-The envelope response is 

sent 

9F YY 

GET RESPONSE 
Data 

91 XX 
Fetch DISPLAY TEXT 

Terminal Response 
DISPLAY TEXT 



Note: Due to an inconsistency in [7] specification it is not possible to cover the test case when an applet try 
to post data in multitriggering. 



6.3.1 .4.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


14,15,16,17,18,19 


CRRN2 


14,15,16,17,18, 19 


CRRN3 


14,15,16,17,18, 19 


CRRC1 


1,2,3,4,5,6,7,8,9,10,11,12,13 



6.3.2 Handler Integrity 
6.3.2.1 ProactiveHandler 

Test Area Reference: FWK_HIN_ PAHD 

6.3.2.1.1 Conformance Requirement 

Normal Execution 

CRRN1: At the processToolkit invocation the TLV-List is cleared. 

CRRN2: After a call to ProactiveHandler.send method the handler will remain unchanged until the 
ProactiveHandler.init or appendTLV method are called. 
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6.3.2.1.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files: 
FWK_HIN_ PAHD_l.scr 
FWK_ HIN_ PAHD_l.java 
FWK_HIN_PAHD_2.j ava 
FWK_ HIN_ PAHD_l.ldr 
FWK_ HIN_ PAHD_l.clr 
FWK_ HIN_ PAHD_l.par 



6.3.2.1.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



At the processToolkit invocation the TLV-List 
is cleared 



Appletl and Applet2 are registered to 
EVENT_UNFORMATTED_SMS_PP_ENV . 



1-An envelope containing an unformatted 
sms pp is sent to the SIM 



2-ProactiveHandler . getLength ( ) method is 
called by Appletl 



1- Appletl is triggered. 



2- The return value is 



TLV-List change after the init method 
invocation 



ProactiveHandler . init ( ) method is called 
by Appletl 

1-ProactiveHandler . getLength ( ) method is 
called by Appletl 



1- The return value is 9 



The TLV-List remains unchanged after the 
send() method invocation 

1-ProactiveHandler . send ( ) method is called 
by Appletl 



2-ProactiveHandler . getLength ( ) method is 
called by Appletl 



It's checked that the content is the same 
than before the calling to send method 
using ProactiveHandler . copyValue and 
Util . arrayCompare methods 

Appletl finalizes 



2- The return value is 9, and its 
contents is the same than before 
the calling to send method 



1 - The proactive command 
is fetched and the terminal 
response is issued. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


At the processToolkit invocation the TLV-List 
is cleared 

1- ProactiveHandler . getLength ( ) method is 
called by Applet2 

2- ProactiveHandler . getValueLength ( ) method 
is called by Applet2 


1- Applet2 is triggered 

2- The return value is 

3- ToolkitException 
UNAVAILABLE ELEMENT is 
thrown 





6.3.2.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2, 3,4 


CRRN2 


3 



6.3.2.2 ProactiveResponseHandler 

Test Area Reference: FWK_HIN_ PRHD 

6.3.2.2.1 Conformance Requirement 

Normal Execution 

CRRN1: The ProactiveResponseHandler content is changed after the call to ProactiveHandler.send method and 
remains unchanged until next call to the ProactiveHandler.send method. 

CRRN2: The ProactiveResponseHandler may not be available before the first call to ProactiveHandler.send method, 
if available the content is cleared. 



6.3.2.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 
FWK_HIN_ PRHD_l.scr 
FWK_ HIN_ PRHD_l.java 
FWK_ HIN_ PRHD_l.ldr 
FWK_ HIN_ PRHD_l.clr 
FWK_ HIN_ PRHD_l.par 
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6.3.2.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration and 
ProactiveResponseHandler obtaining 

1- Applet is registered to all events 
defined in [ 7 ] . 

Using the methods initMenuEntry for 
EVENT_MENU_SE LECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXP IRATION and setEventList ( ) 
for the rest of the events. 

Terminal Profile command is sent to the 
SIM without the facility of SET_EVENT_LIST 
, SETUP_IDLE_MODE_TEXT, SETUP_MENU and 
POLL_INTERVAL. 

For each event: 

2- ProactiveResponseHandler . getTheHandler ( ) 
is called 

If handler is available, 
ProactiveResponseHandler . get Length ( ) is 
called 


1 - No exception is thrown 

2- Applet is triggered. 

3- Behaviour 1 : 
Toolkit Exception 
HANDLER NOT AVAILABLE is 
thrown. 

Behaviour 2: 

No exception is thrown, the return 
value is 




2 


The ProactiveResponseHandler remains 
unchange after send method invocation until 
next send method invocation 

1- Applet builds a proactive command 
ProactiveHandler . send ( ) method is called 

2- ProactiveResponseHandler . getLength ( ) 
method is called 

3- ProactiveHandler . init ( ) method is called 

4- ProactiveHandler . send ( ) method is called 

5- ProactiveResponseHandler . getLength ( ) 
method is called 


1- The ProactiveResponseHandler 
contains the terminal response 

3- The return value is 12 

4- No exception is thrown and the 
Proactive Response Handler 
remains unchanged 

5- The ProactiveResponseHandler 
contains the terminal response of 
the second proactive command 

7- The return value is 1 5 


2- A proactive command is 
fetched 

The terminal response is sent 
with length 12 

6- A proactive command is 
fetched 

The terminal response is sent 
with length 15 



6.3.2.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


1 



6.3.2.3 EnvelopeHandler 

Test Area Reference: FWK_HIN_ ENHD 
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6.3.2.3.1 



Conformance Requirement 



Normal Execution 

CRRN1: The EnvelopeHandler and its content are available for all triggered toolkit applets, from the invocation to 
the termination of their processToolkit method. 

CRRN2: The SIM Toolkit Framework guarantees that all triggered toolkit applets receive the data. 



6.3.2.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 
FWK_HIN_ ENHD_l.scr 
FWK_ HIN_ ENHD_l.java 
FWK_ HIN_ ENHD_l.ldr 
FWK_ HIN_ ENHD_l.clr 
FWK_ HIN_ ENHDJ .par 



6.3.2.3.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet initialization and Envelope Handler 
integrity checks with 
EVENT MENU_SELECTION_HELP_REQUEST 

1- Applet is registered to all events 
defined in [7] except 
EVENT_PROFILE_DOWNLOAD and 
EVENT_STATUS_COMMAND . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SE LECTION, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION, and setEventLlst ( ) 
for the rest of the events. 
Perform SIM initialization with all the 
facilities supported 

2- Envelope menu selection with help request 
is sent to the SIM 

3- EnvelopeHandler . getTheHandler ( ) method is 
called 



4- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_HELP_REQUEST 

5 - A proactive command DISPLAY TEXT is sent 

6- Envelope call control by sim is sent to 
SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 



7- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 -No exception is thrown 



2- Applet is triggered 

3- No exception is thrown. 

4- No exception is thrown 



5- 91 xx. 



6- Applet is triggered 



7- No exception is thrown and the 
handler contains the envelope call 
control by SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 








A nrnaptix/P pnmmanr! 

r\ |JlVJClL»llVC ULHIIIIIdl l\A 

Display Text is fetched 








The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




Check that the TAG_HELP_REQUEST is the TLV 
selected 

8-The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


8- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 




2 


Envelope Handler integrity checks with 
EVENT MENU_SELECTION 

1- An envelope menu selection is sent to 
SIM 

2 - EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . f indTLV { ) method is 
called with TAG_ITEM_IDENTIFIER 


1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






4 - A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 


5- Applet is triggered 


4- 91 XX 




EnvelopeHandler . getTheHandler ( ) method is 
called 








6- It's checked the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 

lldllUlcl OullldIMb lllc cMVtJIUpc Odll 

control by SIM 






The EnvelopeHandler . f indTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 








It's checked that the TAG ITEM IDENTIFIER 
is the TLV selected 




Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 





ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



293 



ETSI TS 101 955 V8.0.0 (2002-09) 



Id 


Description 
Envelope Handler integrity checks with 
EVENT FORMATTED_SMS_PP_ENV 

1- A formatted sms pp envelope is sent to 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_SMS_TPDU 

4 - A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_SMS_TPDU is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


API/Framework Expectation 

1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 

6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


APDU Expectation 

4- 91 XX 

Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 


3 


4 


Envelope Handler integrity checks with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- A unformatted sms pp envelope is sent to 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

4 - A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 


1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 


4- 91 XX 
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Id 



Description 

envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



API/Framework Expectation 

6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 



APDU Expectation 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



Envelope Handler integrity checks with 
EVENT_UNFORMATTED_SMS_CB 

l-A unformatted cellbroadcast envelope is 
sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 



The EnvelopeHandler . findTLV ( ) method is 
called with TAG_CELLBROADCAST_PAGE 

4 - A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



It's checked that the 

TAG_CELLBROADCAST_PAGE is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 
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Id 


Description 
Envelope Handler integrity checks with 
EVENT_TIMER_EXPIRATION 

1- A timer expiration envelope is sent to 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_TIMER_ID 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_TIMER_IDE is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


API/Framework Expectation 

1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 

6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


APDU Expectation 

4- 91 XX 

Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 


6 


7 


Envelope Handler integrity checks with 
EVENT_CALL_CONTROL_BY_SIM 

1- A call control envelope is sent to SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 


1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 


4- 91 XX 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 




8 


Envelope Handler integrity checks with EVENT 
MO_SHORT_MESSAGE_CONTROL_BY SIM 








l-A mo short message control by sim 
envelope is sent to SIM 


1- Applet is triggered 






2 -EnvelopeHandler . getTheHandler ( ) method is 
called 


2- No exception is thrown. 






3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 


o- ino exception is mrown. 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4 -A proactive command DISPLAY TEXT is sent 




4- 91 XX 




5-Envelope call control by sim is sent to 
SIM 


5- Applet is triggered 






EnvelopeHandler . getTheHandler ( ) method is 
called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 


The terminal Response of 
DRPI AY TFXT iq qpnt tn 

uior \ i i i /\ i io oci ii iu 

the SIM 
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Id 

9 



Description 

Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_MT_CALL 

l-A event download mt call envelope is sent 
to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



API/Framework Expectation 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 



APDU Expectation 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



10 



Envelope Handler integrity checks with EVENT 
EVENT JDOWNLOAD_CALL_CONNECTED 

l-A event download call connected envelope 
is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 
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Id 



Description 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



API/Framework Expectation 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 



APDU Expectation 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



11 



Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_CALL_DISCONNECTED 

l-A event download call disconnected 
envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4 - A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 



7- The contents of the envelope 
handler shall be the same as stored 
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Id 



Description 

Util . arrayCompare ( ) 



API/Framework Expectation 

in buffer 1 . 



APDU Expectation 



12 



Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_LOCATION_STATUS 

l-A event download location status envelope 
is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_LOCATION_STATUS 

4 - A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



It's checked that the TAG_LOCATION_STATUS 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


13 


Envelope Handler integrity checks with EVENT_ 








FVFMT nowNi n&n mqfr aptivitv 

LVCIN 1 UWVvNLUAU Uotn Mis II VI IT 








1-A event download user activity envelope 


1- Applet is triggered 






is sent to SIM 








2-EnvelopeHandler . getTheHandler ( ) method is 


0- Mn PYPPntinn iq thrn\A/n 

C IMU CAL<CfJ UU 1 1 lo U 1 1 U Vv I 1 . 






called 








3-Copy the contents of the envelope handler 


3- No exception is thrown. 






in buffer 1 using EnvelopeHandler . copy ( ) 






lilt; rjiivciupcnctiiuici • J liil-i J- -Li v ^ / jiic L iiol-i 








called with TAG_DEVICE_IDENTITIES 








4-A proactive command DISPLAY TEXT is sent 




4- 91 XX 




5-Envelope call control by sim is sent to 








S IM 


5- Applet is triggered 






EnvelopeHandler . getTheHandler ( ) method is 








called 








6-It's checked that the contents of the 








envelope handler is the envelope call 


6- No exception is thrown and the 






control using EnvelopeHandler, copy() and 


handler contains the envelope call 






Util . arrayCompare ( ) methods 


control by SIM 






The EnvelopeHandler . findTLV ( ) method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 












Proactive command Display 








Text is fetched 








The terminal Response of 








UlbrLAY I bA I IS Sent tO 








the blM 












is the TLV selected 








7- The contents of EnvelopeHandler are 


7- The contents of the envelope 






compared with bufferl using 


handler shall be the same as stored 






Util . arrayCompare ( ) 


in buffer 1 




14 


Envelope Handler integrity checks with EVENT_ 








cwcmt nr»\A/Mi oar mi p qprppm a\/aii ar 

EVEINI UUVVNLuMU ILfLL OlsrlEEIN AVAILAD 








LE 








l-A event download idle screen available 


1- Applet is triggered 






envelope is sent to SIM 








2-EnvelopeHandler . getTheHandler ( ) method is 


2- No exception is thrown. 






called 






3-Copy the contents of the envelope handler 








in buffer 1 using EnvelopeHandler . copy ( ) 


3- No exception is thrown. 






The Enve lopeHandle r . findTLV ( ) method is 








called with TAG_DEVICE_IDENTITIES 








4-A proactive command DISPLAY TEXT is sent 








5-Envelope call control by sim is sent to 




4- 91 XX 




SIM 


5- Applet is triggered 






EnvelopeHandler . getTheHandler ( ) method is 








called 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 




15 


Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_CARD_READER_STATUS 

1- A event download card reader status 
envelope is sent to SIM 

2 - EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The Enve lopeHandle r . findTLV ( ) method is 
called with TAG_CARD_READER_STATUS 

4 - A proactive command DISPLAY TEXT is sent 


1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






5-Envelope call control by sim is sent to 
SIM 


5- Applet is triggered 


4- 91 XX 




EnvelopeHandler . getTheHandler ( ) method is 
called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 


Proactive command Display 
Text is fetched 




It's checked that the 

TAG_CARD_READER_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Envelope Handler integrity checks with 
UNRECOGNIZED_ENVELOPE 

1- A unrecognized envelope is sent to SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

4 - A proactive command DISPLAY TEXT is sent 


1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






5-Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

The EnvelopeHandler . getValueLength ( ) is 
called 


5- Applet is triggered 


4- 91 XX 




6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






Call Control execution is finished. 




Proactive command Display 
Text is fetched 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



6.3.2.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3, 4, 5, 6, 7, 8, 9, 10, 11, 
12, 13, 14, 15, 16 


CRRN2 


1,2,3, 4, 5, 6, 7, 8,9, 10, 11, 
12, 13, 14, 15, 16 



6.3.3 Applet Triggering 

6.3.3.1 EVENT_PROFILE_DOWNLOAD 

Test Area Reference: FWK_APT_EPDW 

6.3.3.1.1 Conformance Requirement 

Normal Execution 

CRRN1: Upon the reception of Terminal Profile command by the SIM, the STF stores the ME Profile and then 
triggers the registered toolkit applets. 

CRRN2: The applet is not triggered by the EVENT_PROFILE_DOWNLOAD once it has deregistered from this 
event. 
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CRRN3: The STF shall not reply busy to a Terminal Profile command 



6.3.3.1.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EPDW_1 .scr 
FWK_APT_EPDW_1 j ava 
FWK_APT_EPDW_2.java 
FWK_APT_EPD W_3 .j ava 
FWK_APT_EPDW_1 .ldr 
FWK_APT_EPDW_1 .clr 
FWK_APT_EPDW_1 .par 



6.3.3.1.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applets registration to 
EVENT PROFILE_DOWNLOAD and triggering 

Appletl is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applet2 is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applet3 is not registered to the 
EVENT_PROFILE_DOWNLOAD and is registered 
to EVENT_FORMATTED_SMS_PP_ENV. 

1-Terminal Profile command is sent to SIM 



Appletl execution is finished 



Applet2 execution is finished 



1- Appletl is triggered 



2- Applet2 is triggered 



3- Applet3 is not triggered 



The STF shall not reply busy to a Terminal 
Profile command 

l-Formatted sms pp envelope is sent to SIM 



Applet3 builds a REFRESH proactive command 
in sim initialization mode 

2-ProactiveHandler . send ( ) method is called 
by applet3 



3-Terminal Profile command is sent to SIM 



Appletl calls Toolkit Registry . clearEvent ( 
EVENT_PROFILE_DOWNLOAD) 



1 - Applet3 is triggered by the 

EVENT_FORMATTED_SMS_PP_ 

ENV 



2- A proactive command is 
sent 



Applet3 is suspended until the 
terminal response 

3- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



4- Applet2 is triggered by 
EVENT PROFILE DOWNLOAD 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




4-Applet2 calls Toolkit 
Registry . clearEvent ( 
EVENT_PROFILE_DOWNLOAD) 

ToolkitRegistry . setEvent (EVENT_PROFILE_DOW 
NLOAD) method is called 

Applet3 execution finish 




The terminal Response of 
the proactive command is 
sent 


3 


Deregistered applets are not triggered 

Terminal Profile command is sent to SIM 


Applet3 is triggered 
(Appletl and Applet2 are not 
triggered) 





6.3.3.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


3 


CRRN3 


2 



6.3.3.2 EVE NT_M EN U_S ELECTION 

Test Area Reference: FWK APT EMSE 



6.3.3.2.1 

Normal Execution 



Conformance Requirement 



CRRN1: The applet is triggered by the EVENT_MENU_SELECTION when an Envelope Menu Selection is 
received with the item identifier of a menu entry of this applet if no proactive session is ongoing. 



6.3.3.2.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EMSE_1 .scr 
FWK_APT_EMSE_l.java 
FWK_APT_EMSE_2.j ava 
FWK_APT_EMSE_1 .ldr 
FWK_APT_EMSE_1 .clr 
FWK_APT_EMSE_1 .par 
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6.3.3.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 








EVENT_MENU_SELECTION and triggering 








ToolkitRegistry . initMenuEntry ( ) method is 








called in the constructor of appletl and 








Applet2 . 








For appletl: 








MenuEnt ry=" Applet 1 " 








Of f set=0 








Length=menuEntry . length 


1 - Tho mothnH mi ict roti irn tn 10 

I lilt? 1 1 It? LI IUU 1 1 lUol 1 ClU 1 1 1 LI uc 






HelpSupported=f alse 








IconQualif ier=0 








lconldentifier=0 








For applet2: 








MenuEnt ry= "Applet 2 " 








Of f set=0 








Length=menuEntry . length 








HelpSupported=f alse 








IconQualif ier=0 








lconldentifier=0 








event= EVENT_MENU_SE LECTION 








1-ToolkitRegistry . isEventSet ( ) is called 








in constructor. 








Perform SIM initialization the facility 








SET UP MENU and without the facilities SET 








EVENT LIST and POLL INTEVAL features 










2- Appletl is triqgered and applet2 






2-Item Identifier = 1 


is not triggered 






Event Menu Selection envelope is sent to 






the SIM with the item identifier of a menu 








entry of applet 










3- Applet2 is triggered and appletl 






3-Item Identifier = 2 


is not triggered 






Event Menu Selection envelope is sent to 








the SIM with the item identifier of a menu 








entry of applet 







6.3.3.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST 

Test Area Reference: FWK_APT_EMSH 

6.3.3.3.1 Conformance Requirement 
Normal Execution 

CRRN1: If and ENVELOPE (MENU_SELECTION_HELP_SUPPORTED) command is received for one entry 
supporting help, then STF shall trigger the corresponding applet. 

6.3.3.3.2 Test Suite Files 

Test Script: FWK_APT_EMSH_1. so- 

Test Applet: FWK_APT_EMSH_1 Java 
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FWK_APT_EMSH_2.java 
Load Script: FWK_APT_EMSH_l.ldr 
Cleanup Script: FWK_APT_EMSH_l.clr 
Parameter File: FWK_APT_EMSH_1 .par 



6.3.3.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 








EVENT MENU SELECTION HELP REQUEST 

t V til 1 IVI tllU vJ 1 1 1 V_y | 1 V_/ 1 *l | ItLr ntU l_ \J 1 








and triggering 








ToolkitRegistry . InitMenuEntry ( ) method is 








called in the constructor of appletl and 








Applet2 . 








For Appletl: 








MenuEnt ry= "Applet 1 " 








Of f set=0 








Length=menuEntry . length 








HelpSupported=true 








IconQualif ier=0 








lconldentifier=0 








For Applet2: 








MenuEnt ry= "Applet 2 " 








Offset=0 








Length=menuEntry . length 








HelpSupported=t rue 








IconQualif ier=0 








lconldentifier=0 








event = EVENT_MENU_SELECTION_HELP_REQUEST 


1-The command must return true. 






1-ToolkitRegistry . isEventSet ( ) is called 






in constructor. 








Perform SIM initialization the facility 








SET UP MENU and without the facilities SET 








EVENT LIST and POLL INTEVAL features 








2-Item identifier =1 


2- Appletl is triggered and applet2 






Menu Selection Help Request envelope is 


is not triggered 






sent to the SIM with the item identifier 






of a menu entry of applet 








3-Item identifier =2 








Menu Selection Help Request envelope is 


3- Applet2 is triggered and appletl 






sent to the SIM with the item identifier 


is not triggered 






of a menu entry of applet 





6.3.3.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV 

Test Area Reference: FWK_APT_EFSE 
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Normal Execution 

CRRN1: The applet is triggered by the EVENT_FORMATTED_SMS_PP_ENV once it has registered to this event 
and Formatted Envelope DataDownLoad with the corresponding TAR, defined at the applet loading, is received and 
no proactive session is ongoing 

CRRN2: The applet is not triggered by the EVENT_FORMATTED_SMS_PP_ENV once it has deregistered from 
this event. 



6.3.3.4.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.4.3 



Test Suite Files 

FWK_APT_EFSE_1 .scr 
FWK_APT_EFSE_1 Java 
FWK_APT_EFSE_1 .ldr 
FWK_APT_EFSE_1 .clr 
FWK_APT_EFSE_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to EVENT 
FORMATTED_SMS_PP_EM and triggering 



Applet is registered to 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNIZED_ENVELOPE 



1-An Envelope EVENT_FORMATTED_SMS_PP_ENV 
is sent to the SIM. 



1- Applet is triggered 



Applet deregistration 



ToolkitRegistry . clearEvent ( ) method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

2 -A formatted sms pp envelope is sent to 
the SIM. 



An unrecognized envelope is sent to the 
sim 

ToolkitRegistry . setEvent ( ) method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

3-An Envelope FORMAT TED_SMS_PP_ENV is sent 
to the SIM 



2- Applet is not triggered 



3- Applet is triggered 



6.3.3.4.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.5 EVENT JJNFORMATTED_SMS_PP_ENV 

Test Area Reference: FWK_APT_EUSE 
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Normal Execution 

CRRN1: The applet is triggered by the EVENT_ UNFORMATTED_SMS_PP_ENV once it has registered to this 
event and an Unformatted Envelope DataDownLoad is received if no proactive session is ongoing 

CRRN2: The applet is not triggered by the EVENT_ UNFORMATTED_SMS_PP_ENV once it has deregistered 
from this event. 



6.3.3.5.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EUSE_1 .scr 
FWK_APT_EUSE_1 Java 
FWK_APT_EUSE_1 .ldr 
FWK_APT_EUSE_1 .clr 
FWK_APT_EUSE_1 . par 



6.3.3.5.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_UNFORMATTED_SMS_PP_ENV and 
triggering 



Applet is registered to the 
EVENT_UNFORMATTED_SMS_PP_ENV and 
ENVENT_FORMATTED_SMS_PP_ENV . 

1- Toolkit Registry . isEventSet ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 

2- An Envelope UNFORMATTED_SMS_PP_ENV is 
sent to the SIM. 



1 - The method returns true 



2- Applet is triggered 



Applet deregistration 

Toolkit Registry . clearEvent ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 
1-An unformatted sms pp envelope is sent 
to the SIM. 



A formatted sms pp envelope is sent to the 
sim 

Toolkit Registry . setEvent ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 



2-An Envelope UNFORMATTED_SMS_PP_ENV is 
sent to the SIM 



1- Applet isn't triggered 



2- Applet is triggered 



6.3.3.5.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 
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6.3.3.6 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK APT ECCN 



6.3.3.6.1 



Conformance Requirement 



Normal Execution 

CRRN1: The applet is triggered by the EVENT_CALL_CONTROL_BY_SIM once it has registered to this event 
and an Envelope Call Control is received 

CRRN2: The applet is not triggered by the EVENT_CALL_CONTROL_BY_SIM once it has deregistered from this 
event. 



6.3.3.6.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_ECCN_1 .scr 
FWK_APT_ECCN_1 Java 
FWK_APT_ECCN_1 .ldr 
FWK_APT_ECCN_1 xlr 
FWK_APT_ECCN_1 .par 



6.3.3.6.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applets registration to 
EVENT_CALL_CONTROL_BY_SIM and 
triggering 



Appletl is registered to 
EVENT_CALL„CONTROL_BY_SIM. 



Applet2 is registered to 
EVENT_FORMATTED_SMS_PP_ENV 

1-An Envelope Call control by SIM is sent 
to SIM 



Appletl execution is finished 



1- Appletl is triggered 



Applet deregistration and registration of the 
third applet to EVENT_CALL- 
CONTROL_BY_SIM. 

l-An Envelope Formatted SMS PP envelope is 
sent to SIM 



Applet2 contructs a DISPLAY TEXT proactive 
command . 

2-ProactiveHandler . send ( ) method is called 



3-An Envelope Call control by SIM envelope 
is sent to SIM 



1 -Applet2 is triggered by 

EVENT_FORMATTED_SMS_PP_ 

ENV. 



2- A proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 



3- Appletl is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




ToolkitRegistry . clearEvent ( ) is called for 
EVENT_CALL_CONTROL_B Y_S IM . 
Appletl finalizes. 

ToolkitRegistry . setEvent ( ) method is 
called for EVENT_CALL_CONTROL_B Y_S IM . 

Applet2 is finished 




TERMINAL RESPONSE of 
DISPLAY TEXT is sent to 
the SIM 


3 


Applet triggering 

An Envelope Call control by SIM envelope 
is sent ot SIM 


Applet2 is triggered. 
(Appletl is not triggered) 





6.3.3.6.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3 



6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK_APT_EMCN 



6.3.3.7.1 

Normal Execution 



Conformance Requirement 



CRRN1: The applet is triggered by the EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM once it has 
registered to this event and an Envelope MO Short Message Control. 

CRRN2: The applet is not triggered by the EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM once it has 
deregistered from this event. 



6.3.3.7.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EMCN_1 .scr 
FWK_APT_EMCN_1 Java 
FWK_APT_EMCN_2.j ava 
FWK_APT_EMCN_1 .ldr 
FWK_APT_EMCN_1 .clr 
FWK_APT_EMCN_1 .par 
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6.3.3.7.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT J\10_SHORT_MESSAGE_CONTROL_B 
Y_SIM and triggering 

Appletl is reggistered to 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 

Applet2 is registered to 
EVENT_FORMATTED_SMS_PP_ENV . 

1-An Envelope MO short message envelope is 
sent to SIM 

Appletl execution is finished 


1- Appletl is triggered. 




2 


Applet deregistration and registration of the 

third applet to 
EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM. 

The STF shall not reply busy to a call control 
envelope 

1- An Envelope formatted SMS PP envelope is 
sent to SIM. 

Applet2 builds a DISPLAY TEXT proactive 
command . 

2- ProactiveHandler . send ( ) method is 
called. 

3- An Envelope MO Short message envelope is 
sent to SIM 

ToolkitRegistry . clearEvent ( ) for 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 
Appletl finalizes. 

ToolkitRegistry . setEvent ( ) method is 
called for 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 
Applet2 execution finished. 


1- Applet2 is triggered. 
3- Appletl is triggered. 


2- A Proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 

TERMINAL RESPONSE of 
DISPLAY TEXT is sent to 
the SIM 


3 


Applet3 triggering 

An Envelope MO SMS control by SIM envelope 
is sent ot SIM 


Applet2 is triggered. 
(Appletl is not triggered) 
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CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3 



6.3.3.8 EVE NT_TIMER_EXP I RATION 

Test Area Reference: FWK_APT_ETEX 



6.3.3.8.1 

Normal Execution 



Conformance Requirement 



CRRN1: The applet is triggered by the EVENT_TIMER_EXPIRATION once it has been registered to this event 
and an Envelope Timer Expiration with a Timer Identifier of the applet is received if no proactive session is 
ongoing. 

CRRN2: The applet is not triggered by the EVENT_TIMER_EXPIRATION once it has been deregistered from this 
event. 



6.3.3.8.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.8.3 



Test Suite Files 

FWK_APT_ETEX_1 .scr 
FWK_APT_ETEX_1 .java 
FWK_APT_ETEX_1 .ldr 
FWK_APT_ETEX_1 .clr 
FWK_APT_ETEX_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT TIMER EXPIRATION and 
triggering 

Applet is registered to the 
EVENT_TIMER_EXP I RAT ION using the 
allocateTimer ( ) method and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_TIMER_EXPIRATION 

1- Toolkit Registry . isEventSet ( ) 
method is called. 

2- An Envelope TIMER_EXPIRATION is 
sent to the SIM. 



1 - The method returns true 



2- Applet is triggered. 



Applet deregistration 

Timer id=l 

Toolkit Registry. ReleaseTimer () method 
is called 

1-An Envelope timer expiration is 
sent to the SIM. 



An Envelope formated sms pp envelope 
is sent to the sim 

Toolkit Registry. AllocateTimer () method 
is called 



1- Applet isn't triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2-An Envelope TIMER_EXPIRATION is 
sent to the SIM. 


2- Applet is triggered 





6.3.3.8.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.9 EVENT JJNFORMATTED_SMS_CB 

Test Area Reference: FWK_APT_EUCB 

6.3.3.9.1 Conformance Requirement 

Normal Execution 

CRRN1: The applet is triggered by the EVENT_UNFORMATTED_SMS_CB once it has registered to this event 
and an Envelope Cell Broadcast DownLoad is received. 

CRRN2: The applet is not triggered by the EVENT_UNFORMATTED_SMS_CB once it has deregistered from this 
event. 



6.3.3.9.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.9.3 



Test Suite Files 

FWK_APT_EUCB_1 .scr 
FWK_APT_EUCB_l.java 
FWK_APT_EUCB_1 .ldr 
FWK_APT_EUCB_1 .clr 
FWK_APT_EUCB_1 .par 

Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Applet registration to 
EVENT_UNFORMATTED_SMS_CB and 
triggering 



Applet is registered to the 
EVENT_UNFORMATTED_SMS_CB and 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_UNFORMATTED_SMS_CB 

1- Toolkit Registry. isEventSet () method is 
called. 

2- An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 



1 - Method returns true. 
2- Applet is triggered 



Applet deregistration 



Toolkit Registry . ClearEvent () method is 
called for EVENT_UNFORMATTED_SMS_CB 



1-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 



1- Applet isn't triggered 
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Id 


Description 


API Expectation 


APDU Expectation 




An Envelope formatted sms pp envelope is 
sent to the sim 








event= EVENT_UNFORMATTED_SMS_CB 








Toolkit Registry . setEvent { ) method is called 
for EVENT_UNFORMATTED_SMS_CB 








2-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 


2- Applet is triggered 





6.3.3.9.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 j 


1 


CRRN2 


2 



6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL 

Test Area Reference: FWK APT EDMC 



6.3.3.10.1 



Normal Execution 



Conformance Requirement 



CRRN1: The applet is triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has registered to this 
event and an Envelope Event DownLoad MT Call is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has deregistered 
from this event. 



6.3.3.10.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EMSE_1 .scr 
FWK_APT_EMSE_l.java 
FWK_APT_EMSE_1 .ldr 
FWK_APT_EMSE_1 .clr 
FWK_APT_EMSE_1 .par 
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6.3.3.10.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT EVENT DOWNLOAD MT CALL and 
triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_MT_CALL and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event = EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 


1- The method returns true 

2- Applet is triggered 




2 


Applet deregistration 

event = EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 

An Envelope formatted sms pp envelope is 
sent to the sim 

event = EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.10.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.1 1 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

Test Area Reference: FWK_APT_EDCC 

6.3.3.11.1 Conformance Requirement 

Normal Execution 

CRRN1: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Connected is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
deregistered from this event. 
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6.3.3.11.2 Test Suite Files 

Test Script: FWK_APT_EDCC_l.scr 

Test Applet: FWK_APT_EDCC_1 Java 

Load Script: FWK_APT_EDCC_l.ldr 

Clean-up Script: FWK_APT_EDCC_l.clr 



6.3.3.11.3 Test Procedure 



1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_CALL_CONNECT 
ED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event = EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 


1- Method returns true 

2- Applet is triggered. 




2 


Applet deregistration 

event =EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- A call connected event dowload is sent 
to the SIM. 

An Envelope formatted sms pp envelope is 
sent to the sim 

Event = EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.11.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.1 2 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

Test Area Reference: FWK_APT_EDCD 
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6.3.3.12.1 



Conformance Requirement 



Normal Execution 

CRRN1: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Disconnected is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once it has 
deregistered from this event. 



6.3.3.12.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EDCD_1 .scr 
FWK_APT_EDCD_1 Java 
FWK_APT_EDCD_1 .ldr 
FWK_APT_EDCD_1 .clr 
FWK_APT_EDCD_1 .par 



6.3.3.12.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_CALL_DISCONN 
ECTED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED and 
to EVENT_FORMATTED_SMS_PP_ENV. 



Event=EVENT_EVENT_DOWNLOAD_CALL_D IS CONNECT 
ED 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the SIM. 



1- Method returns true 



2- Applet is triggered. 



Applet deregistration 



Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope 

EVENT_DOWNLOAD_CALL_DISCONNECTED is sent 
to the SIM. 

a formatted sms pp envelope is sent to the 
sim. 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 



1 - Applet isn't triggered 



2- Applet is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




sent to the SIM. 







6.3.3.12.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.1 3 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

Test Area Reference: FWK_APT_EDLS 



6.3.3.13.1 
Normal Execution 



Conformance Requirement 



CRRN1: The applet is triggered by the EVENT_EVENT_DOWNLOAD_LOCATION_STATUS once it has 
registered to this event and an Envelope Event DownLoad Location Status is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LOCATION_STATUS once it has 
deregistered from this event. 



6.3.3.13.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.13.3 



Test Suite Files 

FWK_APT_EDLS_1 .scr 
FWK_APT_EDLS_1 .java 
FWK_APT_EDLS_1 .ldr 
FWK_APT_EDLS_1 .clr 
FWK_APT_EDLS_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_LOACTION STA 
TUS and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS and 
to EVENT_FORMATTED_SMS_PP_ENV. 



Event =EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS is 
sent to the SIM. 



1- Method returns true 



2- Applet is triggered. 



Applet deregistration 

Event =EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



l-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 

a formatted sms pp envelope is sent to the 
sim 



1- Applet isn't triggered 



Event= 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 



2-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 



2- Applet is triggered 



6.3.3.13.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

Test Area Reference: FWK_APT_EDUA 



6.3.3.14.1 
Normal Execution 



Conformance Requirement 



CRRN1: The applet is triggered by the EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY once it has registered 
to this event and an Envelope Event DownLoad User Activity is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has 
deregistered from this event. 



6.3.3.14.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EDUA_1 .scr 
FWK_APT_EDUA_1 Java 
FWK_APT_EDUA_1 .ldr 
FWK_APT_EDUA_1 .clr 
FWK_APT_EDUA_1 .par 
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6.3.3.14.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT EVENT DOWNLOAD USER ACTIVITY 
and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY and to 
EVENT_FORMATTED_SMS_PP_ENV . 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 

a formatted sms pp envelope is sent to the 
sim 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.14.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.15 EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

Test Area Reference: FWK_APT_EDIS 

6.3.3.15.1 Conformance Requirement 
Normal Execution 

CRRN1: The applet is triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE once it 
has registered to this event and an Envelope Event DownLoad Idle Screen Available is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_A VAIL ABLE once 
it has deregistered from this event. 

6.3.3.15.2 Test Suite Files 

Test Script: FWK_APT_EDIS_l.scr 
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Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



FWK_APT_EDIS_1 .java 
FWK_APT_EDIS_1 .ldr 
FWK_APT_EDIS_l.clr 
FWK_APT_EDIS_1 .par 



6.3.3.15.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_ 
AVAILABLE and triggering 



Applet is registered to the 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA ILABLE 

and to EVENT_FORMATTED_SMS_PP_ENV 

Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 



1 - Method retuns true 



2- Applet is triggered 



Applet deregistration 



Event =EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA 
ILABLE 

Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 



1-An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVA ILABLE is 
sent to the SIM. 



1- Applet isn't triggered 



a formatted sms pp envelope is sent to the 
sim 

Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA ILABLE 

Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 



2-An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVA ILABLE is 
sent to the SIM. 



2- Applet is triggered 



6.3.3.15.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Test Area Reference: FWK_APT_EDCR 
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6.3.3.16.1 



Conformance Requirement 



Normal Execution 

CRRN1: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once it has 
registered to this event and Envelope Event DownLoad Card Reader Status is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once it 
has deregistered from this event. 



6.3.3.16.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 
FWK_APT_EDCR_1 .scr 
FWK_APT_EDCR_1 .java 
FWK_APT_EDCR_1 .ldr 
FWK_APT_EDCR_1 xlr 
FWK_APT_EDCR_1 .par 



6.3.3.16.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_CARD_READER 
STATUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
and to EVENT_FORMATTED_SMS„PP__ENV 

Event =EVENT_EVENT_DOWNLOAD_CARD_READER_STA 
TUS 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 



1- Method returns true 



2- Applet is triggered 



Applet deregistration 



Event= 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 



1-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 



1- Applet isn't triggered 



An Envelope formatted sms pp envelope is 
sent to the sim 

Event= 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 


2- Applet is triggered 





6.3.3.16.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK_APT_EUEV 



6.3.3.17.1 
Normal Execution 



Conformance Requirement 



CRRN1: The applet is triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has registered to this 
event and an Unrecognized Envelope is received. 

CRRN2: The applet is not triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has deregistered from 
this event. 



6.3.3.17.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EUEN_1 . SC r 
FWK_APT_EUEN_l.java 
FWK_APT_EUEN_1 .ldr 
FWK_APT_EUEN_1 .clr 
FWK_APT_EUEN_1 .par 
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6.3.3.17.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT UNRECOGNIZED ENVELOPE and 
triggering 

Applet is registered to the 
EVENT_UNRECOGNIZED_ENVELOPE and to 
EVENT_FORMMATTED_SMS_PP_ENV 

Event = EVENT_UNRECOGNIZED_ENVELOPE 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event = EVENT_UNRECOGNIZED_ENVELOPE 
Toolkit Registry . clearEvent () method is 
called 

1- An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 

a formatted sms pp envelope is sent to the 
sim 

Event = EVENT_UNRECOGNIZED_ENVELOPE 
Toolkit Registry . setEvent ( ) method is 
called 

2- An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.17.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.18 EVENT_STATUS_COMMAND 

Test Area Reference: FWK_APT_ESTC 

6.3.3.18.1 Conformance Requirement 
Normal Execution 

CRRN1: The applet is triggered by the EVENT_STATUS_COMMAND once it has registered to this event and a 
Status Command is received. 

CRRN2: The applet is not triggered by the EVENT_STATUS_COMMAND once it has deregistered from this 
event. 

6.3.3.18.2 Test Suite Files 

Test Script: FWK_APT_ESTC_1. so- 

Test Applet: FWK_APT_ESTC_l.java 

FWK_APT_ESTC_2.j ava 

FWK_APT_ESTC_3.java 
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Load Script: FWK_APT_ESTC_l.ldr 
Cleanup Script: FWK_APT_ESTC_l.clr 
Parameter File: FWK_APT_ESTC_1 .par 



6.3.3.18.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_STATUS_COMMAND and triggering 

Appletl is registered to 
EVENT_S TATUS_COMMAND using the 
requestPollInterval () command. 

Applet2 is registered to 
EVENT_STATUS_COMMAND using the 
RequestPollInterval ( ) command. 

Applet3 is registered to 
EVENT_FORMATTED_SMS_PP_ENV . 

1-A status command is sent to SIM 
Appletl execution is finished 
Applet2 execution is finished 


1- Appletl is triggered. 

2- Applet2 is triggered. 

3- Applet 3 is not triggered 




2 


Applet deregistration and registration of the 
third applet to EVENT_STATUS_COMMAND. 
The STF shall not reply busy to a call control 
envelope 

1- A formatted sms pp envelope is sent to 
SIM 

Applet3 builds a DISPLAY TEXT. 

2- ProactiveHandler . send ( ) is called 

3- A status command is sent to SIM. 
requestPollInteval with POLL_NO_DURATION 

la LdllcU 

Appletl finalized 

requestPollInteval with POLL_NO_DURATION 
is called Applet2 finalized 

requestPollInterval ( ) method is called. 
Applet3 execution finished. 


1- Applet3 is triggered. 

3- Appletl is triggered. 

4- Applet2 is triggered. 


2- A proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 

5- TERMINAL RESPONSE 
of DISPLAY TEXT is sent to 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


3 


Applet3 triggering 

Perform SIM initialization with all the 
facilities supported 

Status command is sent to SIM. 


Applet3 is triggered. 
(Appletl and Applet2 are not 
triggered) 





6.3.3.18.4 Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3 



6.3.4 Proactive Command Sending by the STF 
6.3.4.1 System Proactive Commands 

Test Area Reference: FWK_PCS_SPCO 

6.3.4.1.1 Conformance Requirements 
Normal Execution 

CRRN1: When a toolkit applet changes a menu entry of its registry object, the SIM Toolkit Framework shall 
dynamically* update the menu stored in the ME during the current card session 

CRRN2: The STF shall use the data of the EFsume file when issuing the SET UP MENU proactive command. 

CRRN3: For all EVENT_EVENT_DOWNLOAD_ *: When a toolkit applet changes one or more of these requested 
events of its registry object, the STF shall dynamically* update the event list stored in the ME during the current 
card session by SET UP EVENT LIST proactive command. 

*The STF shall send its system proactive command as soon as no proactive session is pending and all the applets 
registered to the current events have been triggered and have returned from the processToolkit method 
invocation. 

6.3.4.1.2 Test Suite Files 

Test Script: FWK_PCS_SPCO_l. so- 
Test Applet: FWK_PCS_SPCO_l.java 
Load Script: FWK_PCS_SPCO_l.ldr 
Cleanup Script: FWK_PCS_SPCO_l.clr 
Parameter File: FWK_PCS_SPCO_l .par 



6.3.4.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Install Applet 1, Registered to the 
EVENT EVENT DOWNLOAD MT CALL and 
EVENT EVENT DOWNLOAD 
LOCATION_STATUS 

Perform SIM initialization with EVENT 
DOWNLOAD facilities supported 




setEventList proactive 
command 

[Event list]= '19020003' 
or '99020003' 


2 


Trigger the applet by ENVELOPE 




1. DISPLAY TEXT 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




(SMS_FORMATTED_PP) command 

Clear the events and build a display text 
command 




Proactive command 

2. SET UP EVENT LIST 
Proactive command 

[CommandQualifier]= OOh 



6.3.4.1.4 Test Coverage 



CRR number 


Test case number 


N1 


see: 

chapter 6.2.9.2, CRRN1, 
chapter 6.2.9.4, CRRN3, 
chapter 6.2.9.5 CRRN4, 
chapter 6.2.9.8 CRRN1 


N2 


see: 

chapter 6.2.9.2 CRRN1, 
chapter 6.2.9.8 CRRN1 


N3 


1,2 



6.3.4.2 Interaction with GSM commands 

Test Area Reference: FWK PCS IGCO 



6.3.4.2.1 



Normal Execution 



Conformance Requirements 



CRRNl: The STF shall process a GSM command even when a proactive command is pending (before and after the 
FETCH command until the terminal response). The STF shall answer with the SW1 and SW2 described in [3] 
and [4]. 



6.3.4.2.2 Test Suite Files 

Test Script: FWK_PCS_IGCO_l. so- 
Test Applet: FWK_PCS_IGCO_l.java 
Load Script: FWK_PCS_IGCO_l.ldr 
Cleanup Script: FWK_PCS_IGCO_l.clr 
Parameter File: FWK_PCS_IGCO_l .par 



6.3.4.2.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Interaction with GSM Commands after 
TERMINAL PROFILE in connection with FETCH 
and TERMINAL RESPONSE 

Applet is registered to Menu Selection 

RST 

TERMINAL PROFILE 

(Profile: supports all facilities except: 
SET UP EVENT LIST, POLL INTERVAL and 
POLLING OFF) 

1- System issues a proactive command 
SETUP_MENU 



2- SELECT MF 

3- GET RESPONSE (6 Bytes) 



1- 91xx 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




4- Failed SELECT File 

5- FETCH 

6- SELECT MF 

7- GET RESPONSE (6 Bytes) 

8- TERMINAL RESPONSE 




2- 9Fxx 

3- 91 xx 

4- 9404 

5- Proactive Command: 
SETUP MENU 

6- 9Fxx 

7- 9000 

8- 9000 


2 


Interaction with GSM Commands after 
ENVELOPE (MENU SELECTION) 
in connection with FETCH and TERMINAL 
RESPONSE 

Menu Entry ID = 0x01 

1- SELECT MF 

2- GET RESPONSE (6 Bytes) 

3- Failed SELECT File 

4- FETCH 

5- SELECT MF 

6- GET RESPONSE (6 Bytes) 

7- TERMINAL RESPONSE 




1- 9FXX 

2- 91 XX 

3- 9404 

4- Proactive Command: 
DISPLAY TEXT 

5- 9FXX 

6- 9000 

7- 9000 


3 


Interaction with GSM Commands after 
TERMINAL RESPONSE in proactive command 
session in connection with FETCH and 
TERMINAL RESPONSE 

Menu Entry ID = 0x02 

1- SELECT MF 

2- GET RESPONSE (6 Bytes) 

3- FETCH 

4- SELECT MF 

5- GET RESPONSE (6 Bytes) 

6- Failed SELECT File 

7- TERMINAL RESPONSE 

8- SELECT MF 

9- GET RESPONSE (6 Bytes) 

10- Failed SELECT File 

11- FETCH 

12- SELECT MF 

13- GET RESPONSE (6 Bytes) 

14- TERMINAL RESPONSE 




1 - 9FXX 
2- 91 XX 
3- Proactive Command: 
DISPLAY TEXT 

4- 9FXX 

5- 9000 

6- 9404 

7- 9000 

8- 9FXX 

9- 91 XX 

1 0- 9404 

1 1 -Proactive Command: 
DISPLAY TEXT 

12- 9FXX 

13- 9000 

14- 9000 



6.3.4.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 



6.3.5 Exception Handling 
6.3.5.1 Hide Exceptions from the ME 

Test Area Reference: FWK_EXH_HEME 
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6.3.5.1.1 Conformance Requirements 

Normal Execution 

CRRN 1 : A toolkit applet may throw an exception, but this error will not be sent to the ME. 
* Because the behaviour of the SIM is not exactly defined for the above CRRN, there are no tests defined here yet. 



6.3.5.2 Interaction with Multiple Triggering 

Test Area Reference: FWK_EXH_IMTG 

6.3.5.2.1 Conformance Requirements 
Normal Execution: 

CRRN1 : An exception thrown by a toolkit applet, will not influence toolkit applets registered to the same event 

6.3.5.2.2 Test Suite Files 

Test Script: FW K_EXH_IMTG _1 .so- 
Test Applet: : FWK_EXH_IMTG _\ .java 
Load Script:: FWK_EXH_IMTG_l.ldr 
Cleanup Script: FWK_EXH_IMTG_l.clr 
Parameter File: FWK_EXH_IMTG_1 .par 



6.3.5.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





Load/install 2 toolkit applets registered to 
EVENT STATUS COMMAND, 
EVENT PROFILE DOWNLOAD, 
EVENT UNRECOGNISED ENVELOPE, 
EVENT EVENT DOWNLOAD MT CALL, 
EVENT UNFORMATTED SMS PP ENV, 
EVENT UNFORMATTED SMS PP UPD, 
EVENT_UNFORMATTED_SMS_CB 

applet 1: Priority= 0x01, 
applet2: Priority= 0x02, 

(i.e. appletl is triggered before applet2) 






1 


Status_Command is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




2 


Profile Download is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




3 


Unrecognised Envelope is sent 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




4 


Event_Download_MT_Call is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




5 


Unformatted_SMS_PP_Env is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




6 


Unformatted_SMS_PP_Upd is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




7 


Unformatted_SMS_CB is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 





6.3.5.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7 



6.3.6 Framework Security Management 

Security Parameters 

The table that follows contains the security parameters that shall be used when the 03.48 security is required in the test 
cases developed in the current section. 



Parameter 


Value in hexadecimal 


KIC 


11 


KID 


L 11 


CNTR 


00 00 00 00 01 


Key for ciphering 


01 41 42 7F DA E8 91 A7 


Key for RC/CC/DS 


01 23 45 67 89 AB CD EF 



If a parameter is not listed explicitly in the above table, the default values of section 4.7.3.1 apply. 



6.3.6.1 Input Data 

Test Area Reference: FWK_FWS_INDA 
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6.3.6.1.1 



Conformance Requirements 



Normal Execution 

CRRN1: If the SIM receives an envelope APDU containing an SMS_DATADOWNLOAD BER TLV formatted 
according to GSM03.48, the SIM Toolkit Framework shall verify the GSM03.48 security of the SMS TPDU. 

CRRN2: The toolkit applet will only be triggered if the TAR is known and the security verified. 

Test Area Files 

FWK_FWS_INDA_1 .scr 
FWK_FWS_INDA_1 .java 
FWK_FWS_INDA_2.java 
FWK_FWS_INDA_1 .ldr 
FWK_FWS_INDA_1 .clr 
FWK_FWS_INDA_1 .par 



6.3.6.1.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



6.3.6.1.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Framework checks the Cryptographic 
checksum and deciphers the data Appletl is 
loaded and installed 

1 -Envelope (SMS-PP) 03.48 formatted is sent 
to the SIM with this features : 

Ciphering; 

Cryptographic checksum; 
No proof of receipt; 
Data = 01 


The applet is triggered. 




2 


Framework checks the Cryptographic 
checksum and deciphers the data 

Applet2 is installed 

1 - Envelope (SMS-PP) 03.48 formatted is sent 
to the SIM with this features : 

Ciphering; 

Cryptographic checksum; 
No proof of receipt; 
TAR of Applet 1 
Data = 02 

2- Envelope (SMS-PP) 03.48 formatted is sent 
to the SIM with this features! 

No ciphering; 

No cryptographic checksum; 
No proof of receipt; 
TAR of Applet 2 
Data = 03 


This Envelope(SMS-PP) triggers 
Applet 1 

This Envelope(SMS-PP) triggers 
Applet 2 


The SIM answers to the 
Envelope with status words 
9000 

The SIM answers to the 
Envelope with status words 
9000 


3 


Envelope(SMS-PP) 03.48 formatted with wrong 
cryptographic checksum 

No ciphering; 

Wrong Cryptographic checksum; 
No proof of receipt; 


No applet is triggered 


The SIM answers to the 
Envelope with status words 
9000 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




TAR of Applet 1 
Data = 04 







6.3.6.1.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 



6.3.6.2 Output Data 

Test Area Reference: FWK_FWS_OUDA 
6.3.6.2.1 Conformance Requirements 

Normal Execution 

CRRN1: The SIM Toolkit Framework shall secure and send the response packet. 



6.3.6.2.2 Test Area Files 



Test Script: 


FWK 


_FWS_ 


_OUDA_ 


_l.scr 


Test Applet: 


FWK 


_FWS_ 


_OUDA_ 


_l.java 


Load Script: 


FWK 


_FWS_ 


_OUDA_ 


.l.ldr 


Cleanup Script: 


FWK 


_FWS_ 


_OUDA_ 


.l.clr 


Parameter File: 


FWK 


_FWS_ 


_OUDA_ 


_l.par 



6.3.6.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Envelope(SMS-PP) 03.48 formatted 

Ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report ; 
no security applied to proof of receipt 
Data in plain text = "APPLET1" 


The applet is triggered and sends a 
"Display Text" proactive command 
with the data received in the 
Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has no 
application data. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue a 
Display Text "APPLET1 ". 


2 


Envelope(SMS-PP) 03.48 formatted 

Ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report; 
no security applied to proof of receipt 
Data in plain text = "APPLET 1" 


The applet posts application data. It 
does not call the 
ProactiveHandler.send() method 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 9000. 


3 


Envelope(SMS-PP) 03.48 formatted 

Ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report; 

no security applied to proof of receipt 


The applet posts application data 
and calls the 

ProactiveHandler.send() method to 
send a "Display Text" proactive 
command with the data received in 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Data in plain text = "TEST" 


the Envelope. 


application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue 
the Display Text "TEST". 


4 


Envelope(SMS-PP) 03.48 formatted 

Ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS - Deliver - Report; 
proof of receipt shall be ciphered 
Data in plain text = "TEST" 


The applet posts application data 
and calls the 

ProactiveHandler.send() method to 
send a "Display Text" proactive 
command with the data received in 
the Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue 
the Display Text "TEST". 


5 


Envelope(SMS-PP) 03.48 formatted 

The Terminal Profile command shall be 
issued with the facility " ' 9EXX ' response 
code for SIM data download error" enabled 

The Envelope (SMS-PP) formatted has to be 
issued with the following features: 
No ciphering; 

Wrong Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report ; 

no security applied to proof of 

receiptData in plain text = "TEST" 


No applet is triggered 


The SIM answers to the 
Envelope with status words 
9Exx and a PoR is retrieved 
with a GetResponse 
command. The Response 
Status Code Octet shall be 
'01'. 



6.3.6.2.4 Test Coverage 



CRR Number j 


Test Case Number 


CRRN1 


1,2,3,4,5 



6.3.7 Envelope Response Posting 



6.3.7.1 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK_ERP_ECCN 

6.3.7.1.1 Conformance Requirements 

Normal Execution 

CRRN1: The SIM Toolkit Framework can't reply busy when an Envelope(Call Control) is sent to the SIM. 



6.3.7.1.1 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 



Test Area Files 

FWK_ERP_ECCN_1 .scr 
FWK_ERP_ECCN_1 Java 
FWK_ERP_ECCN_2.j ava 
FWK_ERP_ECCN_3 .j ava 
FWK_ERP_ECCN_1 .ldr 
FWK_ERP_ECCN_1 .clr 
FWK_ERP_ECCN_1 .par 
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6.3.7.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet 1 is registered on the 
EVENT_CALL_CONTROL BY SIM, Applet2 is 
registered and triggered on the 
EVENT_MENU_SELECTION. 








1- Applet2 invokes the method send () and no 
fetch is performed 

2- Envelope (Call Control) is sent to the 
SIM 

3- Appletl calls the method 

EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming dialling number into 
+11 22 33 44. 


Applet2 is suspended 
Appletl is triggered. 


The SIM answer 9Fxx to the 
Envelope(Call Control) 

The dialling number is 
retrieved with a 
GetResponse command. 
The SIM answers to the Get 
Response command with 
status words 91 xx. 




4 -A Fetch command is sent to the SIM 








5-A Terminal Response command is sent to 
the SIM 


Applet2's execution shall continue. 






6-Delete appletl & applet2 








7-Install applet3 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet 3 is registered on both the events 
EVENT CALL CONTROL BY SIM and 
EVENT_MENU_SELECTION. 

1- Envelope Menu Selection is sent to the 
SIM. 

2- Applet3 invokes the method send () and no 
fetch is performed) 

3- Envelope (Call Control) is sent to the 
SIM 

4- Applet3 calls the method 

EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming dialling number into 
+11 22 33 44. 

5- A Fetch command is sent to the SIM 

6- A Terminal Response command is sent to 
the SIM 


Applet3 is triggered on the 
EVENT_MENU_SELECTION 

Applet3 is suspended on the send() 
method 

Applet3 is triggered on the 
EVENT CALL CONTROL BY SI 
M. 

The Applet3's execution shall 
continue. 


The SIM answer 9Fxx to the 
Envelope(Call Control) 

The dialling number is 
retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 



6.3.7.1.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK_ERP_EMCN 

6.3.7.2.1 Conformance Requirements 
Normal Execution 

CRRN1: The SIM Toolkit Framework can't reply busy when an Envelope(MO-Short Message Control) is sent to 
the SIM. 

6.3.7.2.2 Test Area Files 

Test Script: FWK_ERP_EMCN_l.scr 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



336 



ETSI TS 101 955 V8.0.0 (2002-09) 



Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.7.2.3 



FWK_ERP_EMCN_1 Java 
FWK_ERP_EMCN_2.java 
FWK_ERP_EMCN_3 j ava 
FWK_ERP_EMCN_1 .ldr 
FWK_ERP_EMCN_1 .clr 
FWK_ERP_EMCN_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet 1 is registered on the 
EVENT_MO_SHORT_MESSAGE_CONTROL B 
Y SIM; Applet2 is registered and triggered on 
the EVENT MENU SELECTION. 



1- Applet2 invokes the method send () and no 
fetch is performed) 

2- Envelope (MO-SM control) is sent to the 
SIM 

3- Appletl calls the method 

EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming TP_Destination_Address 
and any RP__Destination_Address of the 
Service Center into +11 22 33 44 



Applet2 is suspended 
Applet 1 is triggered. 



4 - A Fetch command is sent to the SIM 

5- A Terminal Response command is sent to 
the SIM 



6- Delete appletl & applet2 

7- Install applet3 



The Applet's execution shall 
continue. 



The SIM answers 9Fxx to 
the Envelope(MO-Short 
Message Control) 



The 

TP_Destination_Address is 
retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet 3 is registered on both the events 
EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM and EVENT_MENU_SELECTION. 

1-Applet3 invokes the method send () and no 
fetch is performed) 


Applet 3 is suspended on the 
send() method 






2- Envelope (MO-SM control) is sent to the 
SIM 

3- Applet3 calls the method 

EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming TP_Destination_Address 
and any RP__Destination_Address of the 
Service Center into +11 22 33 44. 


Applet3 is triggered on the 
EVENT MO SHORT MESSAGE 
CONTROL_BY_SIM. 


The SIM answers 9Fxx to 
the Envelope(MO-Short 
Message Control) 

The 

TP Destination Address is 

1 1 L/Oulll IULIUI 1 / \\_^ 1 w O O 1 

retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 




4-A Fetch command is sent to the SIM 








5-A Terminal Response command is sent to 
the SIM 


The Applet3's execution shall 
continue. 





6.3.7.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK_ERP_EUEN 

6.3.7.3.1 Conformance Requirements 

Normal Execution 

CRRN1: The EnvelopeResponseHandler is available for the EVENT_UNRECOGNIZED_ENVELOPE. 

Test Area Files 

FWK_ERP_EUEN_1 . scr 
FWK_ERP_EUEN_1 .j ava 
FWK_ERP_EUEN_1 .ldr 
FWK_ERP_EUEN_1 .clr 
FWK_ERP_EUEN_1 .par 



6.3.7.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 
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6.3.7.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


An applet triggered on the 
EVENT UNRECOGNIZED ENVELOPE calls the 
EnvelopeResponseHandler.post() method 


The post() method returns no 
exception 


The SIM answers to the 
Envelope with status words 
9Fxx. The data retrieved 
with the GetResponse 
command are the ones 
posted by the applet. 



6.3.7.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.8 Toolkit Installation 
6.3.8.1 Timers Allocation 

Test Area Reference: FWK_TIN_TMAL 



6.3.8.1.1 Conformance Requirements 
Normal execution 

CRRN1: One toolkit applet can register to several timers, but a timer can only be allocated to one toolkit applet. 
Context errors 

CRRC1 : Allocated timers shall not exceed the maximum number of timers allowed for this applet instance defined 
during installation. 

CRRC2 : The total number of timers allocated for all the applets shall not exceed 8. 

6.3.8.1.2 Test suite files 



Test Script: 


FWK. 


TIN 


TMAL. 


.l.scr 


Test Applet: 


FWK. 


_TIN_ 


TMAL. 


.l.java 




FWK 


_TIN_ 


TMAL. 


.2 Java 




FWK 


TIN 


TMAL. 


_3.java 


Load Script: 


FWK 


TIN. 


TMAL. 


.l.ldr 


Cleanup Script: 


FWK 


TIN. 


TMAL. 


.l.clr 


Parameter File: 


FWK 


TIN. 


TMAL. 


.l.par 
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6.3.8.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


More than 8 timers at the 
instantiation of appletl : check 
that appletl is not installed or 
that it is not possible to 
allocate more than 8 timers . 

Install for install of appletl with 
maximum 9 timers allocated. 

appletl is triggered: we allocate 9 timers 
appletl is selected 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 
only on the 9 th allocateTimer() 


The SIM answers to the 
Envelope with status words 
90 00 

2 behaviours may be 

expected : 
1 . appletl is not found, 
status word 6X XX 
2. appletl has been 
installed and only 8 timers 
are allocated 




Reset the card and delete instance of appletl 






2 


Good installation of applet2 

Install for install of applet2 (maximum 4 
timers allocated) . 




The SIM answers to the 
Envelope with status words 
90 00 


3 


Allocate 4 timers 
Applet2 


No exception shall be thrown. 




4 


Allocate one more timer 
Applet2 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 




5 


Good installation of applet3 

Install for install of applet3 (maximum 8 
timers allocated) . 




The SIM answers to the 
Envelope with status words 
90 00 


6 


Allocate 4 timers 
Applet3 


No exception shall be thrown. 




7 


Allocate one more timer 


Shall throw a ToolkitException with 

macnn MD TIMFR AVAII ARI F 
IcdoUII Nv 1 llvldi nvnlLMDLC 




8 


Check that each timerld (allocated by applet2 
and applet3) is between 1 and 8 and is different 
from each other 







6.3.8.1.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3,8 


C1 


1,7 


C2 


4,5,6 



6.3.8.2 Item Identifier 

Test Area Reference: FWK_TIN_ITID 
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6.3.8.2.1 Conformance Requirements 
Normal execution 

CRRN1: If the requested item identifier in the range [1-127] is not already allocated, then this item identifier shall 
be allocated to the current applet. 

CRRN2: If the requested item identifier is '00', the card shall take the first free value in the range [128,255]. 
Parameters error 

CRRP1: If the requested item identifier is in the range [128,255], then the card shall reject the install command. 
Context errors 

CRRC1: If the requested item identifier in the range [1-127] is already allocated, then the card shall reject the install 
command. 

6.3.8.2.2 Test suite files 



Test Script: 


FWK. 


_TIN_ 


_ITID_ 


.l.scr 


Test Applet: 


FWK. 


TIN. 


_ITID 


_l.java 




FWK 


TIN 


_ITID 


_2.java 




FWK 


TIN. 


_ITID 


_3.java 


Load Script: 


FWK 


.TIN. 


_ITID 


_l.ldr 


Cleanup Script: 


FWK 


TIN. 


_ITID 


_l.clr 


Parameter File: 


FWK 


.TIN. 


_ITID 


_l.par 



6.3.8.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Bad installation of appletl 

Install for install of appletl. The following 
parameters item Id equal to 128 

appletl is selected 




appletl is not found, status 
word 6XXX 


2 


Good installation of appletl 

Install for install of appletl. item Id = 1 for the 
first menu and 127 for the second one 

A Terminal Profile is sent to the card with only 
PROFILE_DOWNLOAD, 
SMS_PP_DOWNLOAD, MEN U_S ELECTION, 




The SIM answers to the 
Envelope with status words 
91 xx to send back to the 
ME the 2 new menus. 

The menus are 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



341 



ETSI TS 101 955 V8.0.0 (2002-09) 



Id 


Description 


API/Framework Expectation 


APDU Expectation 




SET_UP_MENU and COMMAND_RESULT 
facilities. 




(position/itemld/text) 

01/01/menull 

02/127/menul2 


3 


Bad installation of apple t2 
Item identifier already allocated 

Install for install of applet2. 
item Id = 127 

applet2 is selected 




applet2 is not found, status 
word 6X XX 


4 


Good installation of applet2 

Install for install of applet2. 
item Id = 




The SIM answers to the 
Envelope with status words 
91 xx to send back to the 
ME the 3 menus. 

The menus are 
01/01/menull 
02/127/menul2 
03/128/menu21 


5 


Good installation of applet3 

Install for install of applet3. 
item Id = 




The SIM answers to the 
Envelope with status words 
91 xx to send back to the 
ME the 4 menus. 

The menus are 

01/01/menull 

02/127/menul2 

03/128/menu21 

04/129/menu31 


6 


Good delete and installation of applet2 




The SIM answers to the 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Delete instance of applet2 




Terminal Profile with status 
words 91 xx to send back to 
the ME the 3 menus. 




Perform a RESET and a Terminal Profile with the 
facilities of PROFILE_DOWNLOAD, SMS- 
PP_DATA_DOWNLOAD, 
MENU_SELECTION, COMMAND_RESULT 
and SET_UP_MENU 




The menus are 
01/01/menull 
02/127/menul2 
03/129/menu31 




Install for install of applet2. 
item Id = 




The SIM answers to the 
Envelope with status words 
91 xx to send back to the 
ME the 4 menus. 

The menus are 

01/01/menull 

02/127/menul2 

03/128/menu21 

04/129/menu31 



6.3.8.2.4 Test Coverage 



CRR number 


Test case number 


Nl 


2 
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CRR number 


Test case number 


N2 


4,5,6 


PI 


1 


CI 


3 



6.3.8.3 Item Position 

Test Area Reference: FWK_TIN_ITPO 



6.3.8.3.1 



Conformance Requirements 



Normal execution 

CRRN1: The position of the new menu entries is an absolute position among the existing ones. 
CRRN2: If the position identifier is OOh, the menu shall have the last position 

6.3.8.3.2 Test suite files 

Test Script: FWK_TIN_ITPO_l.scr 
Test Applet: FWK_TIN_ ITPO _\ j ava 

FWK_TIN_ ITPO _2.java 

FWK_TIN_ ITPO _3.java 
Load Script: FWK_TIN_ ITPO _l.ldr 

Cleanup Script: FWK_TIN_ ITPO _l.clr 
Parameter File: FWK_TIN_ ITPO _1 .par 



6.3.8.3.3 



Test Procedure 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Installation of appletl 

Perform Install for install of 
applet 1. Posit ion/ It emld 
01/01 
02/02 

A Terminal Profile is sent to the card 




The menus are 
(position/item Id/text) 
01/01/menu11 
02/02/menu12 


2 


Installation of applet2 

Perform Install for install of applet2. 

Posit ion/It emld 

03/03 

04/04 




The SIM answers to the 
Envelope with status words 
91 xx to send back to the ME 
the 4 menus. 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/02/menu12 

03/03/menu21 

04/04/menu22 


3 


Installation of applet3 

Perform Install for install of applet3. 

Posit ion/ It emld 

00/05 




The SIM answers to the 
Envelope with status words 
91 xx to send back to the ME 
the 5 menus. 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/02/menu12 

03/03/menu21 

04/04/menu22 

05/05/menu31 



6.3.8.3.4 Test Coverage 



Note : As Item Position management is not fully specified in the [7] or [8] all possible tests cannot be performed. 



CRR number 


Test case number 


N1 


1,2 


N2 


3 



6.3.8.4 Maximum Text Length for a menu entry 

Test Area Reference: FWK_TIN_MLME 



6.3.8.4.1 Conformance Requirements 
Normal execution 

CRRN1: The maximum length of item text string is defined at the installation of the toolkit applet. 
Parameters errors 

CRRP1: If initMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a menu 
entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 

CRRP2: If changeMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 
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6.3.8.4.2 Test suite files 

Test Script: FWK_TIN_MLME_1. so- 

Test Applet: FWK_TIN_MLME_l.java 
Load Script: FWK_TIN_MLME_l.ldr 
Cleanup Script: FWK_TIN_MLME_l.clr 
Parameter File: FWK_TIN_MLME_ 1 .par 



6.3.8.4.3 Test Procedure 



Id 


Description 


API / Framework Expectation 


APDU Expectation 


i 


Installation of applet with 2 menus not 
exceeding the maximum text length 

Install one applet with 2 menu entries 
allowed and max. text length equal to 10. 
initMenuEntry defined at the install 
(install) command 

MenuEntry = "MenuEntryl " , "MenuEntry2" 

Offset = 

Length = 10 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 






2 


initMenuEntry with a too large length 

initMenuEntry with length equal to 11 

MenuEntry = " MenuEntry03" 

Offset = 

Length = 11 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


Toolkit ExcGpti on 

ALLOWEDLENGTHEXCEEDED 
is thrown 




3 


initMenuEntry with a right length 

initMenuEntry with length parameter equal 
to 10 

MenuEntry = " MenuEntry 3" 
Offset = 
Length = 10 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 




a SET UP MENU (2 items) 
is issued with TLV item 
length equal to 11 (Identifier 
+ Text string of item) 


4 


changeMenuEntry with a right length 

Appletl is triggered by a 
EVENT_MENU_SE LECTION . 

changeMenuEntry of menu 1, with length 
parameter equal to 10 
Id = ' 01 ' 

MenuEntry = "MenuEntry 4" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

Return from processToolkit 




a SET UP MENU (2 items) 
is issued with TLV item 
length equal to 11 (Identifier 
+ Text string of item) 


5 


changeMenuEntry with a too large length 

Appletl is triggered by a 
EVENT_MENU_SE LECTION . 


ToolkitException 

ALLOWEDLENGTHEXCEEDED 
is thrown 


Shall not receive a SET UP 
MENU different from the 
previous one 
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Id 


Description 


API / Framework Expectation 


APDU Expectation 




ChangeMenuEntry of menu 1, with length 
parameter equal to 11 
Id = ' 02 1 

MenuEntry = "MenuEntry05 " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

Return from processToolkit 







6.3.8.4.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1, 3, 4 


CRRP1 


2 


CRRP2 


5 



6.3.8.5 Maximum number of menu entries 

Test Area Reference: F WK_TIN_NB ME 

6.3.8.5.1 Conformance Requirements 
Normal execution 

CRRN1: The maximum number of menu entries is defined at the installation of the toolkit applet and can be the 
maximum number of successful invocations of the method initMenuEntry . 

Parameters errors 

CRRP1: If the menu entry cannot be initialised (e.g. no more item data in applet loading parameter), a 
ToolkitException with the REGISTRY_ERROR reason code is thrown. 

6.3.8.5.2 Test suite files 

Test Script: FWK_TIN_NBME_l.scr 
FWK_TIN_NBME_l.java 
FWK_TIN_NBME_2.j ava 
FWK_TIN_NBME_1 .ldr 
FWK_TIN_NBME_1 .clr 
FWK_TIN_NBME_1 .par 

6.3.8.5.3 Test Procedure 



Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


i 


Installation of applet with 3 menus 

Install (install) applet with max. number 
of menu entry is x 3', defined at the 
install (install) command. 

initMenuEntry for each menu entry allowed 
(3 times) 

MenuEntry = "menul", "menu2", "menu3" 

Offset = 
Length = 5 


No Exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 






2 


initofa4 th menu 

initMenuEnt ry one more time 
MenuEntiry = "menu4" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


ToolkitException 
REGISTRY_ERROR is thrown 


SET UP MENU (3 items) is 
issued with TLV item length 
equal to 6 (Identifier + Text 
string of item) 


3 


Installation of 2 nd applet with menu 

Install (install) another applet, with 
max. number of menu entry is '0', defined 
at the install (install) command. 

initMenuEntry once 
MenuEntry = "menul" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


ToolkitException 
REGISTRY_ERROR is thrown 


Shall not receive a SET UP 
MENU different from the 
previous one 



6.3.8.5.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRP1 


2, 3 



6.3.8.6 Access Domain 

Test Area Reference: FWK_TIN_ACDO 

6.3.8.6.1 Conformance Requirements 
Normal execution 

CRRN1: The Access Domain parameter indicates the mechanism used to control the applet instance access to the 
GSM file System ('00' means full access to the GSM File System, 'FF' means no access to the GSM File System). 

Parameters errors 

CRRP1: If the Access Domain Parameter requested is not supported, the card shall return the Status Word '6A80', 
incorrect parameters in data field, to the Install(Install) command. 

CRRP2: If an applet with Access Domain Parameter FF' (i.e. No Access to the GSM File System) tries to access a 
GSM file (e.g. invoke the updateBinary(..) method) the framework shall throw a SIMViewException with a 
AC_NOT_FULFILLED reason. 

6.3.8.6.2 Test suite files 

Test Script: FWK_TIN_ACDO_l.scr 
Test Applet: FWK_TIN_ACDO_l Java 

FWK_TIN_ACDO_2.j ava 

FWK_TIN_ACDO_3 .j ava 
Load Script: FWK_TIN_ACDO_l.ldr 
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Cleanup Script: FWK_TIN_ACDO_l.clr 
Parameter File: FWK_TIN_ACDO_l .par 



6.3.8.6.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





Install (install) appletl with: 

- Length of Access Domain field value is 
'1' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 

Install (install) applet2 with: 

- Length of Access Domain field value is 
'1' 

- Access Domain Parameter value is 'FF' 
(No access to the GSM File System) 

Install (install) applet3 with: 

- Length of Access Domain field value is 
'1' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 






i 


readBinary/readRecord method with full 
Access Domain Parameter 

1- Select EF-TARU file whose Read access 
condition is ALWAYS 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

2- Select EF-SMS file whose Read access 
condition is CHV1 

Perform the readRecord method: 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

3- Select EF-TRAC file whose Read access 
condition is CHV2 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

4- Select EF-SUME file Read access 
condition is ADM0 

Perform the readBinary method: 
fileOffset = 
resp = abRead [ ] 
respOffset = 
respLength = 3 

5- Select EF-TNR file whose Read access 
condition is NEVER 

Perform the readBinary method: 
fileOffset = 
resp = abRead [] 
respOffset = 
respLength = 3 


1 to 4- no exception is thrown 

5- SIMViewException 
AC_NOT_FULFILLED is thrown 




2 


updateBinary/updateRecord method with full 
Access Domain Parameter 


1 to 4- no exception is thrown 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



For each case, send an Envelope that 
triggers the applet with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

1- Select EF-TNR file whose Update access 
condition is ALWAYS 

Perform the updateBinary method: 

fileOffset = 

resp = abUpdate [FFFFFF] 

respOffset = 

respLength = 3 

2- Select EF-SMS file whose Update access 
condition is CHV1 

Perform the updateRecord method: 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = Oresp = abUpdate [] 
respOffset = 
respLength = 3 

3- Select EF-FDN file whose Update access 
condition is CHV2 

Perform the updateBinary method: 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 

4- Select EF-SUME file Update access 
condition is ADM0 

Perform the updateBinary method: 
fileOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 

5- Select EF-TNU file whose Update access 
condition is NEVER 

Perform the updateBinary method: 
fileOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 



5- SIMViewException 

AC NOT FULFILLED is thrown 



invalidate method with full Access Domain 
Parameter 



1- Select EF-TNR file whose Invalidate 
access condition is ALWAYS 

Perform the invalidate method 

2- Select EF-TIAC file whose Invalidate 
access condition is CHV1 

Perform the invalidate method 

3- Select EF-ADN file whose Invalidate 
access condition is CHV2 

Perform the invalidate method 

4- Select EF-SUME file Invalidate access 
condition is ADM0 

Perform the invalidate method 

5- Select EF-CNIV file whose Invalidate 
access condition is NEVER 

Perform the invalidate method 



1 to 4- no exception is thrown 



5- SIMViewException 

AC NOT FULFILLED is thrown 



rehabilitate method with full Access Domain 
Parameter 



1- Select EF-TNR file whose Rehabilitate 
; A" "A"" 



1 to 4- no exception is thrown 



5- SIMViewException 

AC NOT FULFILLED is thrown 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



350 



ETSI TS 101 955 V8.0.0 (2002-09) 



Id 


Description 


API/Framework Expectation 


APDU Expectation 




access condition is ALWAYS 
Perform the rehabilitate method 

2- Select EF-IMSI file whose Rehabilitate 
access condition is CHV1 

Perform the rehabilitate method 

3- Select EF-ADN file whose Rehabilitate 
access condition is CHV2 

Perform the rehabilitate method 

4- Select EF-SUME file Rehabilitate access 
condition is ADM0 

Perform the rehabilitate method 

5- Select EF-CNRI file whose Rehabilitate 
access condition is NEVER 

Perform the rehabilitate method 






5 


increase method with full Access Domain 
Parameter 

1- Select EF-CNU file whose Increase 
access condition is ALWAYS 
Perform the increase method: 

incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

2- Select EF-ACM file whose Increase 
access condition is CHV1 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

3- Select EF-CIAC file whose Increase 
access condition is CHV2 

Perform the increase method: 
incr = ablncreaseValue!] 
incrOffset = 
resp = abRead[] 
respOffset = 

4- Select EF-CIAA file Increase access 
condition is ADMO 

Perform the increase method: 
incr = ablncreaseValue!] 
incrOffset = 
resp = abRead[] 
respOffset = 

5- Select EF-CNR file whose Increase 
access condition is NEVER 

Perform the increase method 

Appletl finalizes 


1 to 4- no exception is thrown 

5- SIMViewException 
AC_NOT_FULFILLED is thrown 




6 


readBinary method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-TARU file whose Read access 

condition is ALWAYS 

Perform the readBinary method: 

fileOffset = 

resp = abRead[] 

respOffset = 

respLength = 3 

t 


SIMViewException 
AC_NOT_FULFILLED is thrown 




7 


updateRecord method with no Access Domain 


SIMViewException 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SMS file whose Update access 

condition is CHV1 

Perform the updateRecord method: 

fileOffset = 

resp = abUpdate[] 

respOffset = 

respLength = 3 


AC_NOT_FULFILLED is thrown 




8 


invalidate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-ADN file whose Invalidate access 

condition is CHV2 

Perform the invalidate method 


SIMViewException 
AC_NOT_FULFILLED is thrown 




9 


rehabilitate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SUME file Rehabilitate access 

condition is ADM0 

Perform the rehabilitate method 


SIMViewException 
AC_NOT_FULFILLED is thrown 




10 


increase method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-CNR file whose Increase access 

condition is NEVER 

Perform the increase method 

Applet2 finalizes 

Applet3 restore EF-SUME 


SIMViewException 
AC_NOT_FULFILLED is thrown 





6.3.8.6.4 Test Coverage 



Note : As Item Position management is not fully specified in the [7] or [8] all possible tests cannot be performed. 



CRR number j 


Test case number 


CRRN1 


1, 2, 3, 4, 5 


CRRP1 


Not tested 


CRRP2 


6, 7, 8, 9, 10 



6.3.8.7 Priority Level 

Test Area Reference: FWK_TIN_PRLV 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



352 



ETSI TS 101 955 V8.0.0 (2002-09) 



6.3.8.7.1 Conformance Requirements 
Normal execution 

CRRN1: The priority specifies the order of activation of an applet compared to the other applet registered to the 
same event ('01' : Highest priority level, 'FF' : Lowest priority level) 

CRRN2: If two or more applets are registered to the same event and have the same priority level, the applets are 
activated according to their installation date (i.e. the most recent applet is activated first) 

6.3.8.7.2 Test suite files 

Test Script: FWK_TIN_PRLV_x.scr, x from 1 to 12 

Test Applet: FWK_TIN_PRLV_x.java, x from 1 to 12, 8A, 8B, 9A, 9B, 10A, 10B 

Load Script: FWK_TIN_PRLV_x.ldr, x from 1 to 12 

Cleanup Script: FWK_TIN_PRLV_x.clr, x from 1 to 12 

Parameter File: FWK_TIN_PRLV_x.par, x from 1 to 12, , 8 A, 8B, 9 A, 9B, 10A, 10B 

6.3.8.7.3 Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



All applets are registered on an 
EVENT UNFORMATTED SMS PP ENV event 



Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level '2' and applet2 with priority level 
'1', from package fwk_tin_prlv_l . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 



A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 



Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level '1' and applet2 with priority level 
'2', from package fwk_tin_prlv_2 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 



Delete applets instances and packages 



A static variable is used to validate 
triggering order: appletl is 
triggered before applet2. 



Trigger 2 applets with 2 different Priority 
Levels 

Install (install) appletl with priority 
level '80' and applet2 with priority level 
'7F' , from package fwk_tin_prlv_3 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 



A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 



353 



ETSI TS 101 955 V8.0.0 (2002-09) 



4 


Trigger 2 applets with 2 different Priority 
Levels 

Install (install) appletl with priority 
level and applet2 with priority level 
'80', from package fwk_tin_prlv_4 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




5 


Trigger 3 applets with the same Priority Level 

Install (install) applet 1, 2, 3 in this 
order with same priority level from 
package fwk_tin_prlv_5 . 

Send an Envelope that triggers the 3 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages. 


A static variable is used to validate 
triggering order: applet3 is 
triggered before applet2, and 
applet2 is triggered before appletl . 




6 


Trigger 2 applets from 2 classes, with 2 
different Priority Level 

Install (install) appletl from class A 
with priority level '2' 

Install (install) applet2 from class B 
with priority level '1' 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




7 


Trigger 2 applets from 2 classes, with the same 
Priority Level 

Install (install) appletl from class A 
with priority level '1' 

Install (install) applet2 from class B 
with priority level '1' 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




8 


Trigger 2 applets from 2 packages, with 2 
different Priority Level 

Install package fwk_tin_prlv_8 . 
Install (install) appletl from package 
fwk_tin_prlv_8A with priority level '2' 
Install (install) applet2 from package 
fwk_tin_prlv_8B with priority level '1' 
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Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances ad packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




9 


Trigger 2 applets from 2 packages, with the 
same Priority Level 

Install package fwk_tin_prlv__9 . 
Install (install) applets 1 from package 
fwk_tin_prlv_9A and applet2 from package 
fwk_tin_prlv_9B in this order, with same 
priority level 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




10 


Trigger 4 applets from 2 packages 

1- Install packages fwk_tin_prlv_10, 
fwk_tin_prlv_10A and fwk_tin_prlv_10B . 
Install (install) 2 applets 1 then 2 from 
package fwk_tin_prlv_10A, with 
respectively priority levels 1 and 2. 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

2- Install (install) 2 applets 3 then 4 
from package fwk_tin_prlv_10B, with 
respectively priority levels 1 and 2. 

Send an Envelope that triggers the 4 
applets . 

Delete applets instances and packages 


1 - A static variable is used to 
validate triggering order: appletl is 
triggered before applet2 

2- Applet3 is triggered before 
applets 1 , 4, then 2. 




11 


Trigger 4 applets with the same Priority Level 
then delete them one after another and trigger 
them each time 

1- Install (install) applet 1, 2, 3, 4 in 
this order with same priority level from 
package fwk_tin_prlv_ll . 

Send an Enveloppe that triggers the 4 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applet instance 4 

2- Send an Enveloppe that triggers the 3 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applet instance 3 

3- Send an Enveloppe that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 


1 - A static variable is used to 
validate triggering order: applets 
are triggered in order 4, 3, 2, 1 . 

2- Applets are triggered in order 3, 
2, 1. 
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Delete remaining applet instances and 
packages 



3- Applets are triggered in order 2, 
1. 



12 



Trigger 5 applets with different Priority Levels, 
alternating install and delete 

1- Install (install) applets 1, 2, 3, 4 in 
this order with respective priority levels 
1, 2, 1, 2 

Send an Enveloppe that triggers the 4 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 



2- Delete applet instance 1 and install 
(install) applet5 with priority level 2 

Send an Enveloppe that triggers the 4 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 



3- Re-install (install) appletl with 
priority level 1 

Send an Enveloppe that triggers the 5 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 



1 - A static variable is used to 
validate triggering order: applets 
are triggered in order 3, 1 , 4, 2 



2- Applets are triggered in order 3, 
5, 4, 2 



3- Applets are triggered in order 1 , 

3,5,4,2 



6.3.8.7.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1, 2, 3, 4, 6, 8, 10, 12 


CRRN2 


5, 7, 9, 11 



6.3.9 File System Context 
6.3.9.1 Initial Context 

Test Area Reference: FWK FSC INIT 



6.3.9.1.1 Conformance Requirements 

Normal Execution 

CRRN1: At the invocation of the processToolkit method of a toolkit applet, the current file is the MF. 



6.3.9.1.2 

Test Script: 
Test Applet: 

Load Script: 



Test Suite Files 

FWK_FSC_INIT_l.scr 
FWK_FSC_INIT_l.java 
FWK_FSC_INIT_2.java 
FWK FSC INIT l.ldr 
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Cleanup Script: FWK_FSC_INIT_l.clr 
FWK_FSC_INIT_2.clr 
Parameter File: FWK_FSC_INIT_1 .par 



6.3.9.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


MF is the selected DF in processToolkit() 

An ENVELOPE APDU containing a formatted 
SMS PP for Applet 1 is issued to the SIM 
byte[] fci = new byte [10] 
fciOffset = 
fciLength = 7 
status ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 




2 


No EF is selected 

rehabilitate () 


SIMView exception shall be thrown 
with reason NO_EF_SELECTED 




3 


MF is selected even when an applet triggered 
before selected any other file... 

Applets 1 and 2 register to 
higher priority than Applet 2 . 

An ENVELOPE "EVENT - USER ACTIVITY" is 

sent to the SIM 

1 - Applet 1: 

- is triggered by 

event_event_download_user_act ivity 

- selects DF_GSM and EF_IMSI 

2 - Applet 2: 

- is triggered by 

event_event_download_user_act ivity 
fciOffset = 
fciLength = 7 
status ( ) 

3 - rehabilitate () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Shall return 7. 

fci shall contain the following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 

3 - SIMView exception shall be 
thrown with reason 
NO_EF_SELECTED 





6.3.9.1.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1, 2, 3 



6.3.9.2 Context Preservation (current file) 

Test Area Reference: FWK_FSC_CUFI 

6.3.9.2.1 Conformance Requirements 

Normal execution 

CRRN1: When calling the method select (), the current files (file context) of any other applets shall not be changed 
(see GSM 03.19 []- §5.2). 

CRRN2: The select() methods select a file without changing the current file of any other applet or of the subscriber 
session. 

CRRN3: After invocation of ProactiveHandler.send() method: the current file context of the toolkit applet is 
unchanged (see GSM 03.19 [] - §5.2.). 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 357 ETSI TS 101 955 V8.0.0 (2002-09) 



6.3.9.2.2 Test Suite Files 



Tf^ct \rn nt" 

1 CSL OL11JJL. 


FWK BSC 


n ifi 


1 . scr 


1 & C 1" A T~\ T~\ 1 & t " 

1 CSL /\ppicL. 


PWk" P<5P 
r W t\ I v j v.,_ 


PI TPI 


_ 1 Java 




FWK_FSC_ 


_CUFI_ 


_2.java 


Load Script: 


FWK_FSC_ 


_CUFI_ 


.Lldr 


Cleanup Script: 


FWK_FSC_ 


_CUFI_ 


.l.clr 




FWK_FSC_ 


_CUFI_ 


_2.clr 


Parameter File: 


FWK_FSC 


_CUFI_ 


_l.par 



6.3.9.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No change to file context by another applet 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV . 
Applet2 registers to 
EVENT_CALL_CONTROL_B Y_S IM 

1 - Applet 1: 

- is triggered by a formatted SMS 

- selects DF_SIMTEST and EF_TARU 

- fileOffset = 0; dataLength = 2; 
dataOffset = 0; 

- buffer = {OxCA, OxFE } 

- updateBinary () : first 2 bytes of 
EF_TARU are written as "CA FE' . 

- issues a proactive command "Get Inkey". 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL BY SIM 

- selects DF_TELECOM and EF_ADN . 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBinary () info buffer2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 


A GET INKEY proactive 
command is fetched from 
the SIM 


2 


No change to file context by subscriber 
session 

1 - Applet 1 

- issues a proactive command "Get Inkey". 

2 - Subscriber session selects DF_TELECOM 
and EF_ADN. 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBinary () info buffer2 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


No change by applet of subscriber session 
context 

1 - Applet 1: 

- selects DF_SIMTEST and EF_TNU 

- issues a proactive command "Get Inkey". 

2 - subscriber session reads record 1 of 
current file (shall be EF_ADN) 

3 - The terminal response for Get Inkey 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 

2 - READ RECORD 
absolute number 1 shall 
read "FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




reactivates Applet 1, which terminates 
execution 




FF FF FF FF FF FF" (from 
EFadn) 



6.3.9.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


1,2,3 


CRRN3 


1,2 



6.3.9.3 Context Preservation (current record pointer) 

Test Area Reference: FWK FSC CURE 



6.3.9.3.1 



Conformance Requirements 



Normal execution 

CRRN1: When the seek method is called by one applet, the record pointer of any other applet is not changed. 

CRRN2: updateRecord: the current record pointer of other applets / subscriber shall not be changed in case of linear 
fixed EF 

CRRN3: updateRecord: the record pointer of a cyclic EF shall be changed for all other applets / subscriber to the 
record number 1 . 

CRRN4: readRecord: read data bytes of the linear fixed or cyclic EF currently selected by the applet without 
changing the current record pointer of any other applet / subscriber. 

CRRN5: increase: the last updated record of the cyclic EF currently selected becomes record number 1 for every 
other applet and subscriber session. 

6.3.9.3.2 Test Suite Files 

Test Script: FWK_FSC_CURE_l.scr 
Test Applet: FWK_FSC_CURE_l.java 

FWK_FSC_CURE_2.j ava 
Load Script: FWK_FSC_CURE_l.ldr 
Cleanup Script: FWK_FSC_CURE_l.clr 

FWK_FSC_CURE_2.clr 
Parameter File: FWK_FSC_CURE_1 .par 



6.3.9.3.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Seek without affecting another record pointer 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV 
Applet 2 registers to 
EVENT_CALL_CONTROL_B Y_S IM 

1 - Applet 1: 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET IN KEY proactive 
command is fetched from 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL event 

- selects DF_SIMTEST and EF_LARU 

- performs a seek of pattern {0x55} from 
beginning forward, which finds record 1. 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordf) using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing {OxAA, OxAA, OxAA, 
OxAA} 






2 


updateRecord in linear fixed EF without 
affecting current pointer of others 

1 - Applet 1: 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL BY SIM 
event 

- selects DF_SIMTEST and EF_LARU 

- updates record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordf) using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing (OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


readRecord in linear fixed EF without affecting 
current pointer of others 

1 - Applet 1: 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL BY SIM 
event 

- selects DF_SIMTEST and EF_LARU 

- reads record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordf) using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing (OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 
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6.3.9.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


not tested (see Note) 


CRRN4 


3 


CRRN5 


not tested (see Note) 



Note: These requirements have not been tested because of an inconsistent behavior in 03.19, which is foreseen to be 
corrected in future releases. 

6.3.1 Other parts transferred to framework from API 
6.3.1 0.1 A handler is a temporary JCRE Entry Point object 

Test Area Reference: FWK_API_HEPO 

6.3.10.1.1 Conformance Requirement: 

Normal execution 

CRRN1: The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment 
(JCRE) Specification [12]). 

CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

CRRN3: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment 
(JCRE) Specification [12]). 

CRRN4: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

Parameters error 

Context errors 



6.3.10.1.2 Test suite files 



Test Script: 


FWK 


_API_ 


_HEPO_ 


_l.scr 


Test Applet: 


FWK 


_API_ 


_HEPO_ 


_l.java 


Load Script: 


FWK 


_API_ 


_HEPO_ 


_l.ldr 


Cleanup Script: 


FWK 


_API_ 


_HEPO_ 


.l.clr 


Parameter File: 


FWK 


_API_ 


_HEPO_ 


_l.par 



6.3.10.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


EnvelopeHandler.getTheHandler and store it in 
a static field of the toolkit applet 


SecurityException is thrown 




2 


EnvelopeHandler.getTheHandler and store it in 
a field of the toolkit applet 


SecurityException is thrown 




3 


EnvelopeResponseHandler.getTheHandler and 
store it in a static field of the toolkit applet 


SecurityException is thrown 




4 


EnvelopeResponseHandler.getTheHandler and 
store it in a field of the toolkit applet 


SecurityException is thrown 
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5 


ProactiveHandler.getTheHandler and store it in 
a static field of the toolkit applet 


Security Exception is thrown 




6 


ProactiveHandler.getTheHandler and store it in 
a Tieia ot ine iooikii appiei 


SecurityException is thrown 




7 


Build and send a DISPLAY TEXT command to 
De aoie io get me reierence ot ine 
ProactiveReponseHandler 

ProactiveResponseHandler.getTheHandler and 
store it in a static field of the toolkit applet 


SecurityException is thrown 


rroacuve commanu Teicnea 
and terminal response is 
issued 


8 


ProactiveResponseHandler.getTheHandler and 
store it in a field of the toolkit applet 


SecurityException is thrown 





6.3.10.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


3, 4 


N3 


5,6 


N4 


7,8 



6.3.10.2 Transaction 

Test Area Reference: FWK_API_TRAN 

6.3.10.2.1 Conformance Requirement: 

Normal execution 

CRRN1: A pending toolkit applet transaction at the ProactiveHandler.send() method invocation is aborted.. 



6.3.10.2.2 Test suite files 



Test Script: 


FWK 


_API_ 


TRAN. 


_l.scr 


Test Applet: 


FWK 


_API_ 


TRAM 


_l.java 


Load Script: 


FWK 


.API. 


TRAM 


Lldr 


Cleanup Script: 


FWK 


.API. 


TRAM 


.l.clr 


Parameter File: 


FWK 


.API. 


TRAM 


_l.par 



6.3.10.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Verify that transaction is aborted when a 
proactive command is sent 

Initialise a byte field with 0x05 

Build a display text proactive command. 

beginTransaction() 

Update the byte with 0x02 

send the proactive command 

Verify that the byte value is 0x05 
JCSystem.getTransactionDepth() 


Shall return 


Proactive command fetched 
and terminal response is 
issued 
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CRR number 


Test case number 


N1 


1 



6.3.10.3 Timer Id between Applets 

Test Area Reference: FWK_API_TMID 

6.3.10.3.1 Conformance Requirement: 

Context errors 

CRRC1: The method ToolkitRegistry.releaseTimer() shall throw a ToolkitException with INVALID_TIMER_ID 
reason if the timer is valid but isn't allocated to this applet. 



6.3.10.3.2 Test suite files 



Test Script: 


FWK 


_API_ 


TMID_ 


_l.scr 


Test Applet: 


FWK 


_API_ 


_TMID_ 


_l.java 


Load Script: 


FWK 


_API_ 


_TMID_ 


.l.ldr 


Cleanup Script: 


FWK 


_API_ 


_TMID_ 


.l.clr 


Parameter File: 


FWK 


_API_ 


_TMID_ 


_l.par 



6.3.10.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


During installation : 
First instance allocate a timer and store the 
returned value in a static field. 
Second instance allocate a timer. 
Trig second instance and try to releaseTimer() 
with the static field value. 


releaseTimer() shall throw a 

ToolkitException with 
INVALID_TIMERJD reason 





6.3.10.3.4 Test Coverage 



CRR number 


Test case number 


N1 


1 
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Annex A (normative): 

Class and Methods AID numbering and acronyms 



A.1 Sim. access 



Class Name 


Acronyms 


Numbering on 5 bits 


SIMView 


svw 


00001 


SIMSystem 


SSY 


00010 


SIMViewException 


SVE 


00011 


A.1 .1 SIMView methods 


Method Name 


Acronyms 


Numbering on 6 bits 


static final Constants 




000001 


short increase (byte [ ] incr, short incrOffset, byte[] 
resp, short respOffset) 


INCR_BS_BS 


000010 


void invalidate () 


INVL 


000011 


void readBinary (short fileOffset, byte[] resp, short 
respOffset, short respLength) 


REDBS_BSS 


000100 


short readRecord ( short recNumber, byte mode, short 
recOffset, byte[] resp, short respOffset, short 
respLength) 


REDRSBS_BSS 


000101 


void rehabilitate ( ) 


REHA 


000110 


short seek (byte mode, byte[] patt, short pattOffset, 
short pattLength) 


SEEKBBSS 


000111 


void select (short fid) 


SLCTS 


001000 


short select (short fid, byte[] fci, short fciOffset, 
short fciLength) 


SLCTS_BSS 


001001 


short status (byte [ ] fci, short fciOffset, short 
fciLength) 


STAT_BSS 


001010 


short updateBinary ( short fileOffset, byte[] data, 
short dataOffset, short dataLength) 


UPDBS_BSS 


001011 


void updateRecord ( short recNumber, byte mode, short 
recOffset, byte[] data, short dataOffset, short 
dataLength) 


UPDRSBS_BSS 


001100 



A.1 .2 SIMSystem methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static SIMView getTheSIMView ( ) 


GETS 


000001 



A.1. 3 SIMViewException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwlt ( short reason) 


THITS 


000001 


SIMViewException (short reason) 


COORS 


000010 


Constants 


CONS 


000011 
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A.2 Sim.toolkit 



Class Name 


Acronyms 


Numbering on 5 bits 


Tool kit Constants 


TKC 


00001 


Toolkitlnterface 


TKI 


00010 


EditHandler 


EDH 


00011 


EnvelopeHandler 


ENH 


00100 


EnvelopeResponseHandler 


ERH 


00101 


MEProf ile 


MEP 


00110 


ProactiveHandler 


PAH 


00111 


ProactiveResponseHandler 


PRH 


01000 


ToolkitRegistry 


TKR 


01001 


ViewHandler 


VWH 


01010 


Toolkit Except ion 


TKE 


01011 



A.2.1 ToolkitConstants 



Method Name 


Acronyms 


Numbering on 6 bits 


Constants 


CONS 


000001 



A.2. 2 Toolkitlnterface methods 



Method Name 


Acronyms 


Numbering on 6 bits 


void processToolkit (byte event) 


PRTKB 


000001 



A.2.3 EditHandler methods 

The numbering of the EditHandler methods it will be done in the classes inherit it: EnvelopeResponseHandler, 
ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2. 4 EnvelopeHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


byte getEnvelopeTag ( ) 


GENT 


000001 


byte getltemldentif ier ( ) 


GIID 


000010 


short getSecuredDataLength ( ) 


GSDL 


000011 


short getSecuredDataOf f set ( ) 


GSDO 


000100 


EnvelopeHandler getTheHandler ( ) 


GTHD 


000101 


short getTPUDLOffset () 


GTPO 


000110 








Inherited Method Name: ViewHandler 






Byte 

compareValue { short valueOff set , byte [ ] compareBuf fer , 
short compareOf f set , short compareLength) 


CPRVS_BSS 


0001 1 1 


Short 

copy (byte [] dstBuffer, short dstOff set , short dstLengt 
h) 


COPY_BSS 


001000 


Short 

copyValue (short valueOffset, 

byte[] dstBuffer, short dstOff set , short dstLength) 


CPYVS_BSS 


001001 


Byte 

f indAndCompareValue (byte tag, byte [] compareBuf fer, sh 
ort compareOf f set ) 


FACRBBS 


001010 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compare 
Offset, short compareLength) 


FACRBBS_BSS 


001011 


Short 

FindAndCopyValue (byte tag, byte occurence, short value 


FACYBBS_BSS 


001100 
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Offset, byte[] dstBuffer, short dstOffset, 
short dstLength) 






Short 

f indAndCopyValue (byte tag, byte [] dstBuffer, short dst 
Offset) 


FACYBBS 


001101 


Byte 

FindTLV (byte tag, byte occurrence) 


i — ik i r~\ n i — i 

FINDBB 


001 110 


Short 

GetLength () 


GLEN 


001111 


Byte 

GetValueByte (short valueOffset) 


GVBYS 


010000 


Short 
GetValueLength () 


GVLE 


010001 



A.2.5 EnvelopeResponseHandler methods 



Method Name 


Acronym 


Numbering on 6 bits 


EnvelopeResponseHandler getTheHandler ( ) 


GTHD 


000001 


Void post (byte statusType) 


POSTB 


000010 


Void postAsBERTLV (byte statusType, byte tag) 


POSTBB 


000011 








InhpHtpH Mpthnrt Namp* FHitHanrllpr 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA 


000100 


Void appendTLV (byte tag, byte value) 


a n~ri n r~) 

APTLBB 


r\r\r\ -\ r\ ■* 

000101 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLBBSS 


000110 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


000111 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


APTLBB_BSS 


001000 


Void clear () 


CLER 


001001 








Inhpritpd Mpthod Namp* VipwHandlpr 






Byte 

i^mr^ ;^t~£^\7;3~I~i~1£^ f ^ Vi t~t~ its 1 iipnf""Fqpt" V"% \ 7T~ p** i~ 1 i^mr^ ^ t~ p* "Ri i f 7 t 

\J 1 1 L YJ Ql C V aX UC ^ O 11U 1 L V Q.X UCu J LoCL-^i^VL-C |_J L^^Jll L YJ a. J_ C -D LI J Ltii- f 

short compareOf f set , short compareLength) 


CPRVS_BSS 


001010 


Short 

Copy (byte [] dstBuffer, short dstOff set , short dstLengt 
h) 


PHPV DCQ 

UUr Y_DOO 


UU I U I I 


Short 

CopyValue (short valueOffset, 

byte[] dstBuffer, short dstOff set , short dstLength) 


CPYVS_BSS 


001100 


Byte 

FindAndCompareValue (byte tag, byte [] compareBuf fer, sh 
ort compareOf f set ) 


FACRBBS 


001101 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compare 
Offset, short compareLength) 


FACRBBS_BSS 


001110 


Short 

FindAndCopyValue (byte tag, byte occurence, short value 
Offset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


001111 


Short 

f indAndCopyValue (byte tag, byte [] dstBuffer, short dst 
Offset) 


FACYBBS 


010000 


Byte 

FindTLV (byte tag, byte occurrence) 


FINDBB 


010001 


Short 

GetLength () 


GLEN 


010010 


Byte 

GetValueByte (short valueOffset) 


GVBYS 


010011 


Short 
GetValueLength ( ) 


GVLE 


010100 
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A.2.6 MEProfile methods 



Method Name 


Acronym 


Numbering on 6 bits 


Static boolean check (byte index) 


CHECB 


000001 


Static boolean check (byte [] mask, short offset, short 
length) 


CHECBSS 


000010 


A.2.7 ProactiveHandler methods 


Method Name 


Acronyms 


Numbering on 6 bits 


GetTheHandler () 


GTHD 


000001 


Init (byte type, byte qualifier, byte dstDevice) 


INITBBB 


000010 


InitDisplayText (byte qualifier, byte dcs, byte[] 
buffer, short offset, short length) 


INDTBB_BSS 


000011 


InitGet Inkey (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length) 


INGKBBBSS 


000100 


InitGet Input (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length, short minRespLength, 
short maxRespLength) 


INGPBB_BSSSS 


000101 


Byte send ( ) 


SEND 


000110 








Inherited Method Name: EditHandler 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA 


000111 


Void appendTLV (byte tag, byte value) 


APTLBB 


001000 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLBBSS 


001001 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


001010 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


APTLBBBSS 


001011 


Void clear () 


CLER 


001100 








Inherited Method Name: ViewHandler 






Byte 

CompareValue ( short valueOff set , byte [ ] compareBuf fer, s 
hort compareOf f set , short compareLength) 


p n — ) \ / o doo 

OrK VbBbb 


001 1 01 


Short 

Copy (byte [] dstBuf fer, short dstOff set, short dstLength 
} 


UUPYDbb 


001 1 10 


Short 

CopyVci lu.6 (shoirt V9.lu.s0f f sst f 

byte[] dstBuf fer, short dstOff set , short dstLength) 


CPYVS_BSS 


001111 


Byte 

F i ndAndCompa r e Va lue (byte tag, byte [ ] compareBuf fer , sho 
rt compareOf f set ) 


FACRBBS 


010000 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compareO 
f f set, short compareLength) 


FACRBBS_BSS 


010001 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuf fer, short dstOff set, 
short dstLength) 


FACYBBS_BSS 


010010 


Short 

f indAndCopyValue (byte tag, byte [] dstBuf fer, short dstO 
ffset) 


FACYBBS 


010011 


Byte 

FindTLV (byte tag, byte occurrence) 


FINDBB 


010100 


Short 

GetLength () 


GLEN 


010101 


Byte 

GetValueByte ( short valueOffset) 


GVBYS 


010110 


Short 
GetValueLength () 


GVLE 


010111 
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A.2.8 ProactiveResponseHandler methods 



1 VIC L 1 1 VJU I1C1IIIC 


1 \J 1 1 y 1 1 1 o 


1 <l U 1 1 1 UCI 1'iy wl 1 \J UllJ 


Short CopyAdditionallnf ormation (byte [ ] dstBuffer, 
short dstOffset, short dstLength) 




0000(11 


Short copyTextString (byte [ ] dstBuffer, short 
dstOffset) 


CPTS_BS 


000010 


Short getAdditionallnf ormationLength ( ) 


GTIL 


000011 


Byte getGeneralResult ( ) 


GTGR 


000100 


Byte getltemldentif ier ( ) 


GTII 


000101 


Byte getTextStringCodingScheme ( ) 


GTCS 


000110 


Short getTextStringLength ( ) 


GTTL 


000111 


GetTheHandler () 


GTHD 


001000 








Inherited Method Name: ViewHandler 






Byte 

CompareValue ( short valueOff set , byte [ ] compareBuf fer, s 
hort compareOf f set , short compareLength) 


CPRVS_BSS 


001001 


Short 

Copy (byte [] dstBuffer, short dstOffset, short dstLength 
) 


L/Ur Y_DOO 


uui in u 


Short 

CopyValue ( short valueOffset, 

byte[] dstBuffer, short dstOff set , short dstLength) 


r*pv\/c ceo 
Ur Yvo boo 


A A H A-j H 


By t e 

FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set ) 


CApDD DC 
rML/rlD DO 


UU I I uu 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOf f s et , by t e [ ] compareBuf fer, short compareO 
ffset, short compareLength) 


FACRBBS_BSS 


001101 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


rMLilDDO Doo 


UU I I I u 


Short 

f indAndCopyValue (byte tag, byte [] dstBuffer, short dstO 
ffset) 


FACYB BS 


001111 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010000 


Short 

GetLength () 


GLEN 


010001 


Byte 

GetValueByte (short valueOffset) 


GVBYS 


010010 


Short 
GetValueLength () 


GVLE 


010011 
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IvIclliUU IMdlllc 


HOI Ul 1 yi Mo 


Mumhorinn r\tt Kite 
IMU 1 1 1 UCl 1 1 iy UN D UlLo 


AllocateTimer () 


M 1 1 1 VI 


000001 


changeMenuEn t ry (byte id, byte [ ] menuEntry, short 


r^fi /I CTD DCCD7DC 

UMb 1 d_doodZdo 


UUUU1 U 


offset, short length, byte nextAction, boolean 






helpSupport ed, byte iconQualif ier, shoirt 






i con I dent i f i er ) 






clearEvent (byte event) 


CEVTB 


000011 


disableMenuEntry (byte id) 


DMETB 


000100 


enableMenuEntry (byte id) 


EMETB 


000101 


getEnt ry ( ) 


GETY 


0001 10 

\J\J\J 1 1 u 


getPoll Interval () 


brUL 


0001 -i 1 

UUU 1 1 1 


initMenuEntry (byte [ ] menuEntry, short offset, short 


IMET_BSSBZBS 


001000 


length, byte nextAction, boolean helpSupported, byte 






iconQualif ier , short icon I dent if ier ) 






isEventSet (byte event) 


IEVSB 


001001 


releaseTimer (byte timerldentif ier ) 


RTIM 


001010 


requestPollInterval (short duration) 


RPOL 


001011 


setEvent (byte event) 


SEVTB 


001100 


setEventList (byte [ ] eventList, short offset, short 


SEVL BSS 


001101 


length) 







A.2.10 ViewHandler methods 

The numbering of the ViewHandler methods it will be done in the classes inherit it: EditHandler, EnvelopeHandler, 
ProactiveResponseHandler, ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2.11 ToolkitException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


Static void throwlt ( short reason) 


THITS 


000001 


ToolkitException ( short reason) 


COORS 


000010 


Constants 


CONS 


00001 1 
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Annex B (normative): 

Script file syntax and format description 

B. 1 Syntax description 

Following is a syntax description in BNF. 

<statement list> ::= [ <statement> \n] + 

<statement> ::= <simple> I <switch> I <blank lino 

<simple> ::= <reset> I <init> I <command> I <remark> 

<reset> ::= RST 

<init> ::= INI <hexdata> 

<command> ::= CMD <hexdata> [ <response> ] ( <status> ) 

<response> ::= [ <hexdata> ] 

<status> ::= ( <hexdata> ) 

<remark> ::= REM <text line> 

<switch> ::= SWI { [<labelled list>] + } 

<labelled list> ::= <label> : \n <statement list> 

Description of syntax metalanguage : 

\n represents a linebreak 

[ x ] means x can appear optionally 

[ x ] + means 1 or more appearances of x 

x I y means x or y 

[ ] { } : (bold) these are characters that appear literally in the script files 

<text lino any character until the end of the line 
<blank lino a line containing no text is acceptable 

<hexdata> data written in hexadecimal, each byte separated from the following by a whitespace 

Each simple statement beginning with 3 characters different than the ones defined indicates another tool command, and 
shall be ignored by the parser if not recognised. 

' ' , ' \t 1 : Can be used as separator 

A long statement can be broken into several lines by using the character ' V at the end of each line which is not the last 
one in the statement. 

For more details refer to the examples in B.3. 

B.2 Semantics 

Following is the meaning of each of the statements : 
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cmd : Sends an APDU Command to the card, including (optionally) the expected response data and also (optionally) 

the expected status words SW1, SW2. 
rst : Resets and powers on the card 

ini : Performs the terminal profile with the following data. Afterwards, it shall perform all the fetch and terminal 

response commands until there is no proactive session in progress. 
rem : Used for comments 

swi : Activates a switch condition. Every labelled list represents a list of statements to be executed, if the label 
matches the SW resulting from the previously executed command. 



Evaluation of expected response and status in the case of a CMD: 

<response> data within [. . .] has to be checked, it needs to be present for an outgoing command. Bytes written as XX 

shall not be checked by the APDU tool. 
<status> status contained within (...) has to be checked; when several status are valid they shall be separated by 

commas. Bytes written as XX shall not be checked by the APDU tool. 



B.3 Example 

REM this is an example 
RST 

INI FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
REM Case 1 example 

CMD AO C2 00 00 00 (91 33 , 69 XX) 

REM Case 2 example 
CMD AO B6 00 00 07 \ 

[XX XX XX 55 55 XX 55] \ 

(91 33 , 67 XX) 



CMD AO B6 00 00 07 \ 
(91 33 , 67 XX) 

CMD AO CO 00 00 IF \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 28 A4 05 \ 

02 0D CC CC CC CC CC CC CC CC CC CC CC CC CC ] \ 
(90 00) 

REM Case 3 example 

CMD AO C2 00 00 33 \ 

Dl 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \ 
08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \ 
02 70 00 00 0E 0D 00 00 00 00 28 A4 05 00 00 00 \ 
00 00 00 \ 
(90 00) 

REM Case 4 example with switch statement 
CMD 00 A4 04 00 10 \ 

AO 00 00 00 09 00 02 FF FF FF FF 89 41 04 44 02 \ 
(61 XX, 6A 82) 

SWI { 
61 XX: 

CMD 00 CO 00 00 14 \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 41 04 44 \ 
02 02 CC CC] \ 
(90 00) 

CMD AO A4 00 00 02 \ 
3F 00 

6A 82: 
RST 

} 
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B.4 Style and formatting 

In order to show a common appearance all the scripts shall follow those format rules: 

- start always with a 'RST' followed by an INI' command. 

- The command, data to be checked and status to be checked shall be presented in the following order: 
CUD COMMAND [EXPECTED DATA] {EXPECTED STATUS) 

- APDU shall be presented with command (CLA INS PI P2 P3) in one line and data (if present) in next line 
grouped 16 bytes per line (see example above). 

- The expected data (if present) shall be presented in 16 bytes groups per line (see example above). 
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Annex C (normative): 
Default Prepersonalisation 



C.1 General Default Prepersonalisation 

This table shows the default prepersonalisation, the file system and the files' content, that the test SIM cards shall 
contain unless otherwise stated. 



Name 


Idpntif ipr 

1 Uvl 1 L 1 1 1 w 1 


Default Value 


Snprial Fpaturp^ 


thcciD 




OF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF 




This value is not compliant with GSM 11.11 


EFimsi 


6F07 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF 




This value is not compliant with GSM 11.11 


EFlp 


6F05 


01 


FF 


FF 


FF 














EFkc 


6F20 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 07 






EnPI MNkfsl 


6F30 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EFl-IPI MM 
■ — 1 rirLIVIN 


6F31 


05 




EFACMmax 


oro / 


00 


00 


00 














flppocc rnnHitinn I IPRATF - PUIVI 
nOUcoo OU 1 IU 1 LIUI 1 UlUMIC V 1 


EFsst 


oroo 


FF 


3F 


C3 


03 


OC 


00 


FF 


OF 00 33 






tTACM 


broy 


00 


00 


00 














Access conomon urUAit. omvi 


EFpuct 


6F41 


FF 


FF 


FF 


00 


00 










Access condition UPDATE: CHV1 


EFbcch 


6F74 


FF 
FF 


FF 
FF 


FF 
FF 


FF 
FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EFacc 


6F78 


00 


00 


















EFfplmn 


6F7B j 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EFloci 


6F7E 


FF 


FF 


FF 


FF 


00 


F0 


00 


FF 01 






CrAD 


RFAD 


00 


FF 


FF 
















EFphase 


6FAE 


03 




EFfdn 


6F3B 


Default value 


m all 


the records 




Records: 5 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsmsp 


6F42 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 










EFlnd 


6F44 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsmss 


6F43 


FF 


FF 


















EFsms 


6F3C 


1 st 


record : 


00 


FF 


.. FF (length 176 




Records: 3 






2 nd 


record: 00 FF ... 


FF (length 176) 










3 rd 


record : 


00 


FF 


.. FF (length 176 






EFadn 


6F3A 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFccp 


6F3D 


FF 
FF 


FF 
FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EFmsisdn 


6F40 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsdn 


6F49 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsume 


6F54 


85 
53 


OC 
54 


54 
FF 


4F 
FF 


4F 
FF 


4C 
FF 


4B 


49 54 20 54 


45 




EFcbmi 


6F45 


FF 


FF 


















EFim 


4F20 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 







The default value for the CHV1 shall be "0x31 0x31 0x31 0x31 OxFF OxFF OxFF OxFF" and its state shall be 'disabled' 
during test applets execution. 
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C.2 Sim.Access.SimView test default prepersonalisation 
C.2.1 DFsimtest (SIM Test) 

Identifier: '0319' 



C.2. 2 EFtnr (Transparent Never Read) 





Identifier: '6F01' 


j Structure: transparent 


Mandatory 


File size: 3 bytes 


Update activity: low 






Access Conditions: 








READ 


NEVER 








UPDATE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE 


ALWAYS 






Bytes 


Description 


Default Value 


IWO 


Length 


1 -3 


Test Data 


AA AA AA 


M 


3 bytes 



C.2. 3 EFtnu (Transparent Never Update) 





Identifier: '6F02' 


Structure: transparent 


Mandatory 


File size: 3 bytes 


Update activity: low 






Access Conditions: 








READ 




ALWAYS 








UPDATE 


NEVER 








INVALIDATE 


ALWAYS 








REHABILITATE 


ALWAYS 






Bytes 


Description 


Default Value 


M/O 


Length 


1 -3 


Test Data 


55 55 55 


M 


3 bytes 



C.2. 4 EFtaru (Transparent Always Read and Update) 





Identifier: '6F03' 


Structure: transparent 


Mandatory 


File size: 260 bytes 


Update activity: low 






Access Conditions: 








READ 




ALWAYS 








UPDATE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE 


ALWAYS 






Bytes 


Description 


Default Value 


M/O 


Length 


1 -260 


Test Data 




FF... FF 


M 


260 












bytes 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 374 

C.2.5 EFcnr (Cyclic Never Read) 



ETSI TS 101 955 V8.0.0 (2002-09) 



Identifier: '6F04' 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




NEVER 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/O 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.6 EFcnu (Cyclic Never Update) 



Identifier: '6F05' 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




NEVER 






INCREASE 




NEVER 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/O 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.7 EFcnic (Cyclic Never Increase) 



Identifier: '6F06 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




NEVER 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/O 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 
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Identifier: '6F07 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




NEVER 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/O 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.9 EFcnrh (Cyclic Never Rehabilitate) 



Identifier: '6F08' 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




ALWAYS 






REHABILITATE 


NEVER 




Logical 


Description 




Default Value 


M/O 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.10 EFcaru (Cyclic Always Read and Update) 



Identifier: '6F09' } 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/O 


Length 


Record 












Number 












1 


Test Data 


55 55 55 


M 


3 bytes 


2 


Test Data 


AA AA AA 


M 


3 bytes 
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C.2.1 1 EFlnr (Linear Fixed Never Read) 





Identifier: '6F0A' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


Update activity: low 




Access Conditions: 










READ 




NEVER 










UPDATE 




ALWAYS 










INVALIDATE 




ALWAYS 










REHABILITATE 


ALWAYS 








Logical 


Description 




Default Value 




M/O 


Length 


Record 














Number 














1 


Test Data - Record 1 


FF FF FFFF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 2 EFlnu (Linear Fixed Never Update) 





Identifier: '6F0B' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


Update activity: low 




Access Conditions: 










READ 




ALWAYS 










UPDATE 




NEVER 










INVALIDATE 




ALWAYS 










REHABILITATE 


ALWAYS 








Logical 


Description 




Default Value 




M/O 


Length 


Record 














Number 














1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 3 EFlaru (Linear Fixed Always Read and Update) 





Identifier: '6F0C 


Structure: linear fixed [ 


Mandatory 


Record length: 4 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




ALWAYS 








INVALIDATE 




ALWAYS 








REHABILITATE 


ALWAYS 






Logical 


Description 




Default Value 


M/O 


Length 


Record 












Number 












1 


Test Data - Record 1 


55 55 55 55 


M 


4 bytes 


2 


Test Data - Record 2 


AA AA AA AA 


M 


4 bytes 
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C.2.14EF CINA (Cyclic Increase Not Allowed) 



Identifier: '6F0D' 


Structure: cyclic 


Mandatory 


Record length: 3 bytes 


Update activity: high 



Access Conditions: 





READ 
UPDATE 
INCREASE 

INVALIDATE 
REHABILITATE 


ALWAYS 
ALWAYS 
ALWAYS (see note 1) 
ALWAYS 
ALWAYS 






Logical Record 
Number 


Description 


Default Value 


M/O 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



Note 1 : This file will be personalised in a way such that increase is not allowed, as indicated by the 
FCI byte 8, bit 7 (GSM 1 1 .1 1 : FCI structure of an EF returned by the SELECT command) 



C.2.15EF TRAC (Transparent Read Access Condition CHV2) 



Identifier: '6F0E' 




Structure: transparent | 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 








READ 






CHV2 








UPDATE 




ALWAYS 








INCREASE 




ALWAYS 








INVALIDATE 




ALWAYS 








REHABILITATE 




ALWAYS 






Logical Record 


Description 






Default Value 


M/O 


Length 


Number 














1 


Test Data 


00 00 00 


M 


3 bytes 



C.2.16EF T | AC (Transparent Invalidate Access Condition CHV1) 



Identifier: '6F0F' 


Structure: transparent 


Mandatory 


Record length: 3 bytes 


Update activity: low 



Access Conditions: 

READ ALWAYS 

UPDATE ALWAYS 

INCREASE ALWAYS 

INVALIDATE CHV1 

REHABILITATE ALWAYS 



Logical Record 
Number 



Description 



Default Value 



M/O 



Length 



Test Data 



00 00 00 



M 



3 bytes 



ETSI 



3GPP TS 11.13 version 8.0.0 Release 1999 378 ETSI TS 101 955 V8.0.0 (2002-09) 

C.2.17EF CIAC (Cyclic Increase Access Condition CHV2) 



Identifier: '6F10' 


Structure: cyclic 


Mandatory 


Record length: 3 bytes 


Update activity: low 



Access Conditions: 

READ ALWAYS 

UPDATE ALWAYS 

INCREASE CHV2 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 





Logical Record 
Number 


Description 


Default Value 


M/O 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.18EF aAA (Cyclic Increase Access Condition ADM) 



Identifier: '6F11' 




Structure: cyclic 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




ALWAYS 








INCREASE 




ADM 








INVALIDATE 




ALWAYS 








REHABILITATE 




ALWAYS 






Logical Record 


Description 




Default Value 


M/O 


Length 


Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.19EF CNRI (Cyclic Never Rehabilitate Invalidated) 



Identifier: '6F12' 


Structure: cyclic 


Mandatory 


Record length: 3 bytes 


Update activity: low 



Access Conditions: 

READ ALWAYS 

UPDATE ALWAYS 

INCREASE ALWAYS 

INVALIDATE ALWAYS 

REHABILITATE NEVER 





Logical Record 
Number 


Description 


Default Value 


M/O 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



The file status shall be invalidated as defined in [3] 
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Annex D (normative): 

sim.test.util package and loading , testing and cleaning 
script examples. 

See attached files: 

Annex_D_SimTestUtil.zip 
Annex_D_Examples.zip 
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Annex E (normative): 
Test Area files. 

See attached file: 

- Annex_E_SourceCode.zip 
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Annex F (Normative): 

AID numbering and acronyms for Framework tests 



F.1 Toolkit Installation Parameters (TIN) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Timer allocation 


TMAL 


000001 


Item identifier 


ITID 


000010 


Item position 


ITPO 


000011 


Access conditions 


ACCO 


000100 


Priority level 


PRLV 


000101 


Maximum length for each menu entry 


MLME 


000110 


Number of menu entries 


NBME 


000111 


Memory space 


MESP 


001000 



F.2 Minimum Handler Availability (MHA) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


ProactiveResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


EnvelopeResponseHandler 


ERHD 


000100 
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F.3 Handler Integrity (HIN) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


ProactiveResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


RFU (EnvelopeResponseHandler) 


(ERHD) 


000100 



F.4 Applet Triggering (APT) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


EVENT PROFILE DOWNLOAD 


EPDW 


000001 


EVENT MENU SELECTION 


EMSE 


000010 


EVENT MENU SELECTION HELP REQUEST 


EMSH 


000011 


EVENT FORMATTED SMS PP ENV 


EFSE 


000100 


EVENT UNFORMATTED SMS PP ENV 


EUSE 


000101 


EVENT CALL CONTROL BY SIM 


ECCN 


000110 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000111 


EVENT TIMER EXPIRATION 


ETEX 


001000 


EVENT UNFORMATTED SMS CB 


EUCB 


001001 


EVENT EVENT DOWNLOAD MT CALL 


EDMC 


001010 


EVENT EVENT DOWNLOAD CALL CONNECTED 


EDCC 


001011 


EVENT EVENT DOWNLOAD CALL DISCONNECTED 


EDCD 


001100 


EVENT EVENT DOWNLOAD LOCATION STATUS 


EDLS 


001101 


EVENT EVENT DOWNLOAD USER ACTIVITY 


EDUA 


001110 


EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 


EDIS 


001111 


EVENT EVENT DOWNLOAD CARD READER STATUS 


EDCR 


010000 


RFU (EVENT UNRECOGNIZED ENVELOPE) 


(EUEN) 


010001 


EVENT STATUS COMMAND 


ESTC 


010010 



F.5 Proactive Command Sending (PCS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


System Proactive commands 


SPCO 


000001 


Interaction with GSM commands 


IGCO 


000010 


Errors during proactive command sending 


EPCS 


000011 



F.6 Envelope Response Posting (ERP) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


EVENT CALL CONTROL BY SIM 


ECCN 


000001 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000010 


EVENT UNRECOGNIZED ENVELOPE 


EUEN 


000011 



F.7 Framework Security (FWS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Input data 


INDA 


000001 


Output data 


OUDA 


000010 
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F.8 File System Context (FSC) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Initial Context 


INIT 


000001 


Context Preservation for Current File 


CUFI 


000010 


Context Preservation for Current Record 


CURE 


000011 



F.9 Exception Handling (EXH) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Hide exception to the mobile 


HEME 


000001 


Interaction with multi-triggering 


IMTG 


000010 



F.10 Other parts transferred to framework from API (API) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


A handler is a temporary JCRE Entry Point object 


HEPO 


000001 


Transaction 


TRAN 


000010 


Timer Id between Applets 


TMID 


000011 
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Annex G (Normative): Configuration Parameters File 

This file describes all the mandatory and optional parameters that are used in order to create the loading script(s) for one 
test area. The configuration parameters file contains the values for the parameters needed in order to generate the 
loading and cleanup scripts. 

The name of the parameters file will be <test area reference>_<n>.par. 

The number <n> is associated with the loading/cleanup script number, i.e. API_2_TKR_ SEVL_BSS_l.par is used to 
generate API_2_TKR_ SEVL_BSS_l.ldr etc. 



G.1 Syntax 

The general syntax for this file will be: 

<file> ::= <section>+ 

<section> ::= <section heading> <line break> <section body> 
<section heading> ::= ' [' <name> '] ' 
<section body> ::= <parameter assignment>+ 

<parameter assignment> ::= <name> ,= ' <value> <line break> 
Where '+' indicates one or more repetitions of the previous syntax element. 

Any text included between the symbol ' ; ' and the end of line is considered a comment and ignored by parsing tools. 

Empty values are considered valid. They are used to indicate that an optional value is not present. 

Names of sections, names of parameters and values are case-sensitive. 

Blank spaces and Tabs between tokens are allowed and will be ignored by the parser. 

When values represent a sequence of bytes, they are expressed in hexadecimal format, where every 2 digits represent 
one byte. Blank space between bytes is optional. 



Example: 



; comment 




[Sectionl] 




Parameter 1 1 


= 00 11 22 33 


Parameterl2 


= 0101 ; another comment 


[Section2] 




Parameter2 1 


= vvwwxxyyzz 



G.2 File Contents and Organisation 

Parameters in this file are organised in the following sections: 
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[CONVERT] 


Conversion parameters used during conversion (i.e. CAP file generation) 


[INSTALL(load)] 


Parameters used by the Install for Load command 


[LOAD] 


Parameters used by the Load command 


[INSTALL(install)] 


Parameters used by the Install for Install command 



All sections may appear only once in the file, except for the "INSTALL(install)" section. If that section appears more 
than once, it will apply to different applet instances, in sequence. 

G.2.1 Default values, order and processing 

The ordering of the parameters and the sections is relevant, since parameter names may be repeated and apply to 
different applets. 

When one single parameter is repeated within one section, it refers to different applets. The value of the n' appearance 
of the parameter applies to applet n. 

When one section is repeated (INSTALL(install)), then the n' h appearance of the section applies to applet n. 
Parameter/value pairs which are found in one appearance of the section are valid for the subsequent applets as long as 
they are not overriden. For example, first INSTALL(install) may contain all values for parameters, whereas the 
subsequent INSTALL(install) sections may only contain parameters whose values change. 

If one required parameter is missing from one section, the last defined value of this parameter in a previous section of 
the same file will be used. 



G.2.2 CONVERT Section 

These parameters allow configuration of the conversion process of the Java class file(s) into one CAP file. 



Parameter 


Description 


PackageAID 


AID of the package 


PackageName 


Fully qualified name of the package 


PackageVersion 


Version of the package 


AppletClassAID 


AID of the applet 


AppletClassName 


Name of the applet 



G.2.3 INSTALL(load) Section 

Here are the parameters to be included in the Install(Load) command (as specified in GSM 03.48 [8] ). 



Parameter 


Description 


PackageAID 


AID of the package 


PackageNonVolatileMemSize 


Non Volatile memory space (in bytes) required for package loading 


InstallationNonVolatileMemSize 


Non volatile memory required for installation, in bytes 


InstallationVolatileMemSize 


Volatile memory required for installation, in bytes 



G.2.4 LOAD Section 

Here are the parameters to be included in the Load command (as specified in GSM 03.48 [8] ). 



Parameter 


Description 


MaxLoadCommandDataLength 


Maximum length of the data provided in the load command (P3 
parameter of the LOAD APDU embedded in the command packet) 



G.2.5 INSTALL(install) Section 

Here are the parameters to be included in the Install(Install) command (as specified in GSM 03.48 [8] 
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Parameter 


Description 


PackageAID 


AID of the package 


AppletClassAID 


AID of the applet 


InstanceAID 


AID of the instance of the applet 


InstallationNonVolatileMemSize 


Non volatile memory required for installation, in bytes 


InstallationVolatileMemSize 


Volatile memory required for installation, in bytes 


AccessDomain 


Specify the SIM files that may be accessed by the applet and the 
operations allowed on these files. This parameter includes the 
mccgss uomain rarameier ^mut) ana mccgss uomain uaia ^muu) 


PriorityLevel 


Priority level of the Toolkit applet instance 


MaxNumberOfTimers 


Maximum number of timers allowed for this applet instance 


MaxMenu Entry TextLength 


Maximum text length for a menu entry 


MaxNumberOf Menu Entries 


Maximum number of menu entries allowed for this applet instance 


MenuEntriesPositionldentifier 


For each menu entry: Position and identifier of that menu entry 


AppletSpecificParameters 


Parameters specific to the applet 



The applet shall be installed with install(install and make selectable) command. 



G.3 Full example 



[CONVERT] 














PackageAID = AO 00 00 00 30 00 02 FF FF FF FF 


59 00 


00 


01 


00 




PackageName = sim . test . access . api_l_svw_updrbs 














PackageVersion = 1.0 














AppletClassAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


9 


00 


00 


01 


01 


AppletClassName = API_1_SVW_UPDRBS_1 














AppletClassAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


9 


00 


00 


01 


02 


AppletClassName = AP I_1_SVW_UPDRBS_2 














[INSTALL (load) ] 














PackageNonVolatileMemSize = 0D27 














; InstallationNonVolatileMemSize = 0400 














; InstallationVolatileMemSize = 0000 














[ LOAD ] 














MaxLoadCommandDataLength = 6C ; max value 














[INSTALL (install) ] 














AppletClassAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


9 


00 


00 


01 


01 


InstanceAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


9 


00 


00 


01 


01 


InstallationNonVolatileMemSize = 0400 














InstallationVolatileMemSize = 0000 














AccessDomain = 00 














PriorityLevel = FF 














MaxNumberOfTimers = 00 














MaxMenuEntryTextLength = 10 
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MaxNumberOfMenuEntries = 01 










MenuEntriesPositionldentif ier = 0001 










AppletSpecif icParameters = 










[INSTALL (install) ] 










AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 


89 00 


00 


01 


02 


InstanceAID = AO 00 00 00 30 00 02 FF FF FF FF 


89 00 


00 


01 


02 


InstallationNonVolatileMemSize = 0200 










InstallationVolatileMemSize = 0000 










MenuEntriesPositionldentif ier = 0002 











; rest of INSTALL ( install ) parameters are taken from previous INSTALL ( install ) ... 
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Annex H (informative): 
Change history 



The table below indicates all changes that have been made to the present document since drafting work began. 



Change history 


Date 


TSG # 


TSG Doc 


CR 


Rev 


Cat 


Subject/Comment 


Old 


New 


2000-10 












Draft presented at T3 #1 6 




0.2.0 


?nnn-i 9 


TP-1 


TP-nnnpop. 








r I cocl ILcU IU I OU I ft I U I U I IIIIUMIIdLIUII 


n 9 n 


1 n n 


2001-01 












Input to T3 #17 resulting from T3 ad hoc #24 


1.0.0 


1.1.0 


2001-03 












Document presented for approval at T3 #1 8 


1.1.0 


1.2.0 


onrn no 
tL\)\j \ -Uo 


1 r- 1 1 


1 r-Ul UU41 








Doument presented for approval to TSG-T #1 1 (identical 
in technical content to v1 .2.0) 


1 .£.1) 


o r\ r\ 


2001-03 












As approved at TSG-T #1 1 (identical in technical content 
to V2.0.0) 


2.0.0 


7.0.0 


2001-05 












Correction to date on cover page / headers 


7.0.0 


7.0.1 


2001-06 


TP-1 2 


TP-010105 


A001 




F 


Corrections to the API Test plan, addition of the test area 
files and modification of the util package 


7.0.1 


7.1.0 


2001-09 


TP-13 


TP-010206 


A002 




F 


Update API Test plan and Test Area Files 


7.1.0 


7.2.0 


2001-11 


TP-1 4 


TP-010241 


A003 




F 


Specification for framework part 


7.2.0 


7.3.0 


TP-010241 


A004 




F 


API part 


2002-03 


TP-15 


TP-020073 


004 




F 


Testing Framework Update 


7.3.0 


7.4.0 


2002-03 












Files for Annexes D and E added, Editorial correction 
performed in 6.3.2.3.3 colomn 9 (1- Applet triggered) 


7.4.0 


7.4.1 


2002-09 


T3#24 










Reference [14] changed as TS 101 220 v3.0.0 was 
withdrawn. 


7.4.1 


7.4.2 


2002-09 


TP-1 7 










Specification upgraded to release 99 without any 
changes. The technical content is identical to the 
previous version 7.4.2 


7.4.2 


8.0.0 
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